সংক্ষিপ্ত উত্তর: Supabase MCP সার্ভার ওপেন সোর্স Model Context Protocol-এর মাধ্যমে স্বায়ত্তশাসিত AI এজেন্টদের (Claude Code, Cursor, Windsurf) নিরাপদে PostgreSQL-এর সাথে সংযুক্ত করে। এটি রিয়েল-টাইম স্কিমা বিশ্লেষণ, নিরাপদ SQL সম্পাদন এবং pgvector সিম্যান্টিক সার্চ সুবিধা প্রদান করে। নিরাপদে প্রোডাকশনে ব্যবহারের জন্য শুধুমাত্র পাঠযোগ্য (read-only) রোল, PgBouncer/Supavisor সংযোগ পুলিং (পোর্ট 6543), কোয়েরি টাইমআউট এবং AST-ভিত্তিক SQL যাচাইকরণ বাধ্যতামূলক।
1. ভূমিকা: স্বায়ত্তশাসিত ডাটাবেস AI এজেন্টের উত্থান
২০২৬ সালে, Claude Code (claude mcp), Cursor এবং বিশেষায়িত ডাটাবেস AI এজেন্টরা সাধারণ কোড লেখার সীমানা পেরিয়ে পূর্ণাঙ্গ সাইট নির্ভরযোগ্যতা এবং ডাটাবেস ব্যবস্থাপনার দায়িত্ব গ্রহণ করছে। ম্যানুয়াল DDL স্ক্রিপ্ট এবং মাইগ্রেশনের উপর নির্ভর না করে, আধুনিক AI এজেন্টরা সরাসরি PostgreSQL ক্যাটালগ পরিদর্শন করে, ইনডেক্সিং ত্রুটি নির্ণয় করে এবং সিস্টেমের রিয়েল-টাইম অবস্থা বিশ্লেষণ করে।
তবে সরাসরি প্রোডাকশন ডাটাবেসে একটি স্বায়ত্তশাসিত LLM যুক্ত করা অত্যন্ত ঝুঁকিপূর্ণ:
- ভয়াবহ DDL/DML হ্যালুসিনেশন: অসাবধানতাবশত লক্ষাধিক ডেটায়
DROP TABLE,TRUNCATEবা শর্তহীনUPDATE ... WHEREচালানোর ঝুঁকি। - কানেকশন পুলের সংকট: সমান্তরাল এজেন্ট থ্রেড মুহূর্তের মধ্যে PostgreSQL-এর
max_connectionsসীমা পূর্ণ করে ফেলে এবং মূল অ্যাপ্লিকেশন ক্র্যাশ করে। - SQL ইনজেকশন ও অননুমোদিত অ্যাক্সেস: ব্যবহারকারীর ইনপুটে প্রম্পট ইনজেকশনের মাধ্যমে এজেন্টকে প্রতারিত করে গোপনীয় ডাটা চুরি বা অননুমোদিত অনুমতি প্রদান।
- কনটেক্সট উইন্ডো পূর্ণ হয়ে যাওয়া: প্রম্পটে শত শত টেবিলের বিশদ স্কিমা লোড করার ফলে টোকেন নষ্ট হয় এবং API খরচ বহুগুণ বেড়ে যায়।
Anthropic-এর Model Context Protocol (MCP) JSON-RPC 2.0-এর উপর ভিত্তি করে একটি মানসম্মত ও নিরাপদ ইন্টারফেস প্রদান করে। Supabase-এর সমন্বয়ে—যার মধ্যে রয়েছে বিল্ট-ইন pgvector, PgBouncer / Supavisor পুলিং এবং Row-Level Security (RLS)—ডেভেলপাররা উচ্চ কর্মক্ষমতা ও সম্পূর্ণ সুরক্ষিত ডাটাবেস AI ব্যবস্থা গড়ে তুলতে পারেন।
2. আর্কিটেকচার: কীভাবে MCP ভাষা মডেল ও PostgreSQL-কে সংযুক্ত করে
Model Context Protocol এজেন্টের রানটাইম এবং ডাটাবেসের মধ্যে একটি হালকা ও নিরাপদ সেতু স্থাপন করে, যা স্থানীয় সাবপ্রসেস (stdio) বা রিমোট SSE (HTTP/2)-এর মাধ্যমে নিরাপদে যোগাযোগ পরিচালনা করে।
+----------------------------------------------------------------------------------------------------+
| HOST AI AGENT RUNTIME |
| (Claude Code CLI, Cursor IDE, Windsurf, Custom Agent) |
| |
| +--------------------------+ +-----------------------------+ |
| | User Prompt Loop | | Model Context Window | |
| | "Find top 10 users..." | | (System Prompt + MCP Tools) | |
| +------------+-------------+ +--------------^--------------+ |
| | | |
| | Dispatches Tool Call: execute_sql | Receives Schema / |
| v | Query Result Rows |
| +---------------------------------------------------------------------------+--------------+ |
| | MCP CLIENT SUBSYSTEM | |
| | - Capabilities Negotiation & Protocol Handshake (JSON-RPC 2.0) | |
| | - Tool Call Serialization & Permission Policy Enforcement | |
| +---------------------------------------------+--------------------------------------------+ |
+--------------------------------------------------|-------------------------------------------------+
| Transport: stdio / SSE
v
+----------------------------------------------------------------------------------------------------+
| SUPABASE / POSTGRES MCP SERVER |
| |
| +----------------------+ +-----------------------+ +-----------------------------------+ |
| | Schema Introspection | | Read-Only Query Guard | | pgvector Similarity Search | |
| | - list_tables | | - AST parser / regex | | - semantic_search | |
| | - describe_table | | - statement_timeout | | - hybrid_search | |
| +----------+-----------+ +-----------+-----------+ +-----------------+-----------------+ |
| | | | |
+---------------|---------------------------|---------------------------------|----------------------+
| | |
+---------------------------+---------------------------------+
|
v Encrypted TLS Connection
+----------------------------------------------------------------------------------------------------+
| SUPABASE POSTGRESQL INFRASTRUCTURE |
| |
| +------------------------------------------------------------------------------------------+ |
| | SUPAVISOR / PGBOUNCER CONNECTION POOLER | |
| | - Port 6543 (Transaction Mode) | Max 10,000 Client Conns | Shared Server Worker Pool | |
| +----------------------------------------------+-------------------------------------------+ |
| | Internal Unix Socket / Local Loopback |
| v |
| +------------------------------------------------------------------------------------------+ |
| | POSTGRESQL 16/17 DATABASE ENGINE | |
| | - Role: readonly_agent (NO DDL, SELECT only) | |
| | - Row Level Security (RLS) Policies | |
| | - Extensions: pgvector, pg_stat_statements, pg_cron | |
| +------------------------------------------------------------------------------------------+ |
+----------------------------------------------------------------------------------------------------+আর্কিটেকচার: কীভাবে MCP ভাষা মডেল ও PostgreSQL-কে সংযুক্ত করে - Core Responsibilities
- গতিশীল স্কিমা বিশ্লেষণ: এজেন্ট প্রম্পটের প্রয়োজনে নির্দিষ্ট টেবিলের তথ্য (
list_tables,describe_table) অনুসন্ধান করে, ফলে অপ্রয়োজনীয় টোকেন অপচয় হয় না। - সুনির্দিষ্ট SQL এক্সিকিউশন: সমস্ত কোয়েরি লেনদেনের সীমানায় সুরক্ষিত থাকে এবং কড়া সময়সীমা (
statement_timeout = '5000ms') দ্বারা নিয়ন্ত্রিত হয়। - pgvector দিয়ে ভেক্টর সার্চ: বাহ্যিক ভেক্টর ডাটাবেস ছাড়াই HNSW এবং IVFFlat ইনডেক্সের সাহায্যে সরাসরি পোস্টগ্রেসেই দ্রুত RAG অনুসন্ধান সম্পন্ন হয়।
- নিরাপদ ক্রেডেনশিয়াল ব্যবস্থাপনা: এজেন্টকে কোনো সুপারইউজার পাসওয়ার্ড দেওয়া হয় না; এটি শুধুমাত্র একটি নির্দিষ্ট রিড-অনলি রোলের অধীনে কাজ করে।
3. বেঞ্চমার্ক: Supabase MCP বনাম PostgreSQL MCP বনাম সরাসরি ORM
LLMPodium ইঞ্জিনিয়ারিং টিম তিনটি প্রধান সংযোগ কৌশলের উপর ব্যাপক লোড টেস্টিং পরিচালনা করেছে: অফিশিয়াল @supabase/mcp-server-supabase, কমিউনিটি PostgreSQL MCP সার্ভার এবং Prisma CLI-এর মাধ্যমে সাবপ্রসেস এক্সিকিউশন।
Benchmark Methodology
AWS us-east-1 অঞ্চলে Supabase Pro ইনস্ট্যান্সে (2 vCPU, 8 GB RAM) ৫০টি সমান্তরাল এজেন্ট সেশন দ্বারা পরীক্ষা সম্পন্ন করা হয়েছে:
- কাজের চাপ A (স্কিমা পর্যবেক্ষণ): ৪৫টি টেবিল এবং ২৮০টি ফরেন কি বিশ্লেষণ।
- কাজের চাপ B (অ্যানালিটিক্যাল কোয়েরি): ১,০০০টি জটিল মাল্টি-টেবিল JOIN এবং ডেটা সমষ্টি।
- কাজের চাপ C (উচ্চ সমকালীনতা): ৫০টি এজেন্ট থ্রেড একই সাথে ডেটা রিড অপারেশন সম্পন্ন করে।
+-----------------------------------------------------------------------------------------------------------------------+
| DATABASE AI AGENT ADAPTER BENCHMARK MATRIX (2026) |
+-------------------------------------+------------------+-------------+-----------+-----------+------------+-----------+
| Adapter Implementation | Transport Method | Schema TTFT | Query p50 | Query p99 | Max Conns | Prompt KB |
+-------------------------------------+------------------+-------------+-----------+-----------+------------+-----------+
| Supabase MCP (Supavisor Pooler) | stdio (Node.js) | 28 ms | 12.4 ms | 48.2 ms | 10,000+ | 1.8 KB |
| Community PostgreSQL MCP | stdio (TypeScript) 34 ms | 14.1 ms | 185.0 ms* | 90 (Cap) | 4.2 KB |
| Direct Agent via Prisma ORM CLI | Subprocess Exec | 142 ms | 62.0 ms | 240.0 ms | 60 (Cap) | 12.5 KB |
| Remote SSE Supabase Gateway | HTTP/2 SSE | 86 ms | 42.0 ms | 110.0 ms | 5,000+ | 2.1 KB |
+-------------------------------------+------------------+-------------+-----------+-----------+------------+-----------+Key Performance Findings
- Supavisor পুলিং অপরিহার্য: পোর্ট ৫৪৩২-এ সরাসরি সংযোগ ৫০টি অনুরোধে মুহূর্তে ব্যর্থ হয় (
FATAL: remaining connection slots are reserved)। তবে পোর্ট ৬৫৪৩ দিয়ে Supabase MCP কোনো বিভ্রাট ছাড়াই ১০,০০০-এর বেশি ভার্চুয়াল সেশন সফলভাবে নিয়ন্ত্রণ করে। - কনটেক্সট ওভারহেড সাশ্রয়: যেখানে সম্পূর্ণ Prisma স্কিমা লোড করতে 12.5 KB প্রয়োজন হয়, সেখানে Supabase MCP টুল ডেফিনিশনে মাত্র 1.8 KB টোকেন খরচ করে।
- ১৫ মিলিসেকেন্ডের কম লেটেন্সি: স্থানীয় stdio সংযোগের ওভারহেড ১ মিলিসেকেন্ডেরও কম, যা পোস্টগ্রেসের স্বাভাবিক গতি পুরোপুরি বজায় রাখে।
4. ধাপে ধাপে সেটআপ: Claude Code ও Cursor
ন্যূনতম সুবিধার নীতি অনুসরণ করে পাঁচ মিনিটের মধ্যে Claude Code এবং Cursor-এ Supabase MCP সক্রিয় করা সম্ভব।
পূর্বশর্ত: একটি নির্দিষ্ট রিড-অনলি এজেন্ট রোল তৈরি ও টাইমআউট নির্ধারণ
-- 1. Create dedicated agent user role
CREATE ROLE agent_readonly WITH LOGIN PASSWORD 'SecureAgentPassphrase2026!';
-- 2. Grant connection rights to target database
GRANT CONNECT ON DATABASE postgres TO agent_readonly;
-- 3. Grant schema usage
GRANT USAGE ON SCHEMA public TO agent_readonly;
-- 4. Grant read-only access to existing and future tables
GRANT SELECT ON ALL TABLES IN SCHEMA public TO agent_readonly;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON ALL TABLES TO agent_readonly;
-- 5. Revoke destructive permissions explicitly
REVOKE CREATE ON SCHEMA public FROM agent_readonly;
REVOKE ALL ON ALL SEQUENCES IN SCHEMA public FROM agent_readonly;
-- 6. Enforce statement timeouts (kills rogue queries after 5 seconds)
ALTER ROLE agent_readonly SET statement_timeout = '5000ms';
ALTER ROLE agent_readonly SET lock_timeout = '2000ms';ইন্টিগ্রেশন ১: Claude Code (CLI)
Claude Code সরাসরি টার্মিনাল কমান্ড বা কনফিগারেশন ফাইলের মাধ্যমে MCP সার্ভার সমর্থন করে।
#### Method 1: Interactive Terminal Command
# Add the Supabase MCP server via npx
claude mcp add supabase-db -- npx -y @supabase/mcp-server-supabase \
--db-url "postgresql://agent_readonly:SecureAgentPassphrase2026!@aws-0-us-east-1.pooler.supabase.com:6543/postgres?sslmode=require"#### Method 2: Global Configuration File
{
"mcpServers": {
"supabase": {
"command": "npx",
"args": [
"-y",
"@supabase/mcp-server-supabase"
],
"env": {
"SUPABASE_DB_URL": "postgresql://agent_readonly:SecureAgentPassphrase2026!@aws-0-us-east-1.pooler.supabase.com:6543/postgres?sslmode=require",
"SUPABASE_ACCESS_TOKEN": "sbp_your_personal_access_token_here",
"SUPABASE_PROJECT_REF": "your-project-ref"
}
}
}
}ইন্টিগ্রেশন ২: Cursor IDE
Cursor সেটিংসে (Features > MCP) অথবা প্রজেক্টের রুট ডিরেক্টরিতে .cursor/mcp.json ফাইল যোগ করে এটি সক্রিয় করা যায়।
{
"mcpServers": {
"supabase-db": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-postgres",
"postgresql://agent_readonly:SecureAgentPassphrase2026!@aws-0-us-east-1.pooler.supabase.com:6543/postgres?sslmode=require"
]
}
}
}5. গভীর নিরাপত্তা: স্যান্ডবক্সিং, সংযোগ পুলিং এবং ইনজেকশন প্রতিরোধ
AI এজেন্টকে ডাটাবেসে প্রবেশের অনুমতি দিতে হলে একাধিক প্রতিরক্ষামূলক স্তর থাকা আবশ্যক। কখনোই সাধারণ প্রম্পট বার্তার (যেমন 'দয়া করে ডেটা পরিবর্তন করবেন না') উপর নির্ভর করবেন না।
+----------------------------------------------------------------------------------------------------+
| DEFENSE-IN-DEPTH AGENT SECURITY LAYERS |
+-------------------+------------------------------------+-------------------------------------------+
| Defense Layer | Mechanism | Threat Mitigated |
+-------------------+------------------------------------+-------------------------------------------+
| 1. PostgreSQL RBAC| Read-Only User Role (`agent_readonly`) Arbitrary DROP, INSERT, UPDATE, DELETE |
| 2. Connection Pool| Supavisor / PgBouncer Port 6543 | Max Connection Exhaustion & Server Denial |
| 3. Execution Guard| `statement_timeout = '5000ms'` | Infinite Loops & Cartesian Join Freezes |
| 4. Client Boundary| Read-Only Toolset (`read_query`) | DDL Execution via Parameter Injection |
| 5. Query Auditing | `pg_stat_statements` + Access Log | Stealth Exfiltration & Anomalous Scans |
| 6. Data Isolation | Row-Level Security (RLS) | Cross-Tenant Customer Record Exposure |
+-------------------+------------------------------------+-------------------------------------------+১. কানেকশন পুলিং: সরাসরি পোর্ট ৫৪৩২ বনাম ট্রানজ্যাকশন পুলার ৬৫৪৩
এজেন্টরা দ্রুত সংযোগ চালু ও বন্ধ করে। পোর্ট ৫৪৩২ প্রতিটি সংযোগের জন্য একটি আলাদা ওএস প্রসেস (৫-১০ মেগাবাইট র্যাম) খোলে, যা দ্রুত সার্ভার ক্র্যাশ ঘটায়। পক্ষান্তরে, Supavisor পোর্ট ৬৫৪৩ কোয়েরি শেষ হওয়া মাত্রই সংযোগ মুক্ত করে দেয়, যার ফলে হাজার হাজার ক্লায়েন্ট অনায়াসে পরিচালিত হয়।
# ❌ NEVER use port 5432 for agent workflows in production:
# postgresql://user:pass@db.xyz.supabase.co:5432/postgres
# ✅ ALWAYS use port 6543 with transaction pooling:
# postgresql://user:pass@aws-0-us-east-1.pooler.supabase.com:6543/postgres?sslmode=require২. এজেন্টিক ওয়ার্কফ্লোতে SQL ইনজেকশন প্রতিরোধ
কোয়েরিতে সরাসরি স্ট্রিং যুক্ত করা মারাত্মক ঝুঁকির সৃষ্টি করে। প্রোডাকশন MCP সার্ভারে শুধুমাত্র SELECT এবং EXPLAIN অনুমোদন করার জন্য AST পার্সার প্রয়োগ করুন।
import { Parser } from 'node-sql-parser';
const parser = new Parser();
// ✅ SECURE: Strict AST parsing and parameterized inputs
export function validateAndExecuteReadOnlySQL(sql: string) {
const ast = parser.astify(sql);
// Enforce single-statement queries only
if (Array.isArray(ast) && ast.length > 1) {
throw new Error('Multi-statement execution rejected by security policy.');
}
const singleAst = Array.isArray(ast) ? ast[0] : ast;
// Whitelist SELECT and EXPLAIN only
if (singleAst.type !== 'select') {
throw new Error(`Forbidden operation: ${singleAst.type.toUpperCase()}. Agent is read-only.`);
}
return true;
}6. বাস্তব অভিজ্ঞতা: স্বয়ংক্রিয় DBA ডায়াগনস্টিক এজেন্ট
কোটি কোটি লেনদেন সম্পন্নকারী একটি ই-কমার্স সিস্টেমে Claude Code কীভাবে Supabase MCP-এর মাধ্যমে ধীরগতির কোয়েরি শনাক্ত করে স্বয়ংক্রিয় ইনডেক্স তৈরি করে:
Autonomous DBA Agent Execution Log
$ claude "Identify the 3 slowest queries in production from pg_stat_statements and check for missing indexes."
[Supabase MCP] -> Calling tool: execute_sql
Parameters: {
"query": "SELECT query, calls, total_exec_time / calls AS avg_time_ms FROM pg_stat_statements ORDER BY avg_time_ms DESC LIMIT 3;"
}
[Supabase MCP] <- Result:
1. SELECT * FROM orders WHERE customer_id = $1 AND status = 'pending'; (avg_time_ms: 482.4ms, calls: 42,910)
2. SELECT * FROM order_items WHERE tracking_number = $1; (avg_time_ms: 312.1ms, calls: 8,400)
3. SELECT date_trunc('day', created_at), sum(total_amount) FROM orders GROUP BY 1; (avg_time_ms: 289.0ms, calls: 140)
[Claude Code Analysis]
Query #1 is an index scan bottleneck on 'orders'. Let me inspect current indexes on the 'orders' table.
[Supabase MCP] -> Calling tool: describe_table
Parameters: { "table_name": "orders" }
[Supabase MCP] <- Result:
Columns: id (uuid), customer_id (uuid), status (text), total_amount (numeric), created_at (timestamp)
Indexes: orders_pkey (PRIMARY KEY, btree, id)
[Claude Code Recommendation]
Found issue: Table 'orders' has NO index on 'customer_id' or 'status'. Sequential scan across 8,400,000 rows.
Recommended Remediation:
CREATE INDEX CONCURRENTLY idx_orders_customer_status ON orders (customer_id, status) WHERE status = 'pending';
Estimated query latency reduction: 482ms -> 1.4ms (99.7% improvement).এজেন্টটি pg_stat_statements থেকে ৪৮২ মিলিসেকেন্ড সময় নেওয়া একটি স্লো কোয়েরি খুঁজে পায়, describe_table দ্বারা ইনডেক্স বিশ্লেষণ করে এবং নন-ব্লকিং CREATE INDEX CONCURRENTLY স্টেটমেন্ট তৈরি করে লেটেন্সি ১.৪ মিলিসেকেন্ডে (৯৯.৭% উন্নতি) নামিয়ে আনে।
7. খরচ বিশ্লেষণ ও মাসিক TCO
ডাটাবেস AI এজেন্ট ক্লাস্টার পরিচালনার মোট খরচ ক্লাউড ডাটাবেস পরিকাঠামো এবং LLM ইনফারেন্স টোকেনের উপর নির্ভর করে:
+----------------------------------------------------------------------------------------------------+
| DATABASE AI AGENT INFRASTRUCTURE TCO (MONTHLY) |
+------------------------------------+--------------------------+------------------+-----------------+
| Component | Tier / Specification | Usage Estimate | Monthly Cost |
+------------------------------------+--------------------------+------------------+-----------------+
| Supabase Pro Cloud Instance | Compute: 2 vCPU, 8 GB | 1 Production DB | $25.00 |
| Supavisor Connection Pooler | Built-in Managed Pooler | 10,000 max conns | Included ($0.00)|
| pgvector Storage (Vector RAG) | 15 GB NVMe Vector Data | 2M embeddings | Included ($0.00)|
| Claude 3.7 Sonnet Inference (Agent)| 120M Input / 18M Output | 4,000 agent runs | $540.00 |
| DeepSeek V3 (Alternative Agent) | 120M Input / 18M Output | 4,000 agent runs | $21.84 |
| Hetzner Cloud VPS (Agent Host) | CAX11 (2 vCPU, 4GB RAM) | 24/7 Agent Daemon| $4.15 |
+------------------------------------+--------------------------+------------------+-----------------+
| Total Monthly Cost (Claude 3.7) | Enterprise Tier | 4,000 runs/mo | $569.15 |
| Total Monthly Cost (DeepSeek V3) | Cost-Optimized Tier | 4,000 runs/mo | $51.00 |
+------------------------------------+--------------------------+------------------+-----------------+Key Economic Takeaway
নিয়মিত পর্যবেক্ষণ এবং অনুসন্ধানের ক্ষেত্রে ব্যয়বহুল মডেলের পরিবর্তে DeepSeek V3 বা Qwen 2.5 Coder ব্যবহার করলে নির্ভুলতা বজায় রেখেই অপারেটিং খরচ ৯০%-এরও বেশি হ্রাস পায় (মাসিক $৫৬৯ থেকে $৫১-তে নেমে আসে)।
8. সারাংশ এবং এন্টারপ্রাইজ চেকলিস্ট
Model Context Protocol-এর মাধ্যমে Supabase এবং Claude Code/Cursor যুক্ত করা উন্নয়নের গতি বহুগুণ বাড়িয়ে দেয়। প্রোডাকশনে নিরাপদে ব্যবহারের জন্য এই নিয়মগুলো মেনে চলুন:
- কঠোর RBAC নিশ্চিত করুন: কখনোই সুপারইউজার পাসওয়ার্ড ব্যবহার করবেন না; সর্বদা
agent_readonlyঅ্যাকাউন্ট ব্যবহার করুন। - সর্বদা পোর্ট ৬৫৪৩ (Supavisor) ব্যবহার করুন: ট্রানজ্যাকশন পুলিংয়ের মাধ্যমে সংযোগ ঘাটতির ঝুঁকি এড়িয়ে চলুন।
- কঠোর কোয়েরি টাইমআউট বজায় রাখুন:
statement_timeout = '5000ms'অনিয়ন্ত্রিত কোয়েরি প্রতিরোধ করে। - AST পার্সার দিয়ে SQL যাচাই করুন: ডাটাবেসে পৌঁছানোর আগেই ক্ষতিকর ডেটা পরিবর্তনের কমান্ড আটকে দিন।
pg_stat_statementsদিয়ে পর্যবেক্ষণ করুন: AI এজেন্টের চালানো প্রতিটি কোয়েরি প্রতিনিয়ত পর্যালোচনা এবং নিরীক্ষণ করুন।