MCP सर्वर
क्लाउड डेस्कटॉप, कर्सर, विंडसर्फ, एंटीग्रेविटी, मिस्ट्रल एआई, वीएस कोड या किसी मॉडल कॉन्टेक्स्ट प्रोटोकॉल संगत क्लाइंट से अपने Aurabase बैकएंड को नियंत्रित करें - 86 उपकरण, कोई निर्मित मूल्य नहीं।
डिफ़ॉल्ट रूप से स्थानीय stdio मोड, स्थानीय HTTP मोड#
आधिकारिक Aurabase MCP सर्वर आपके बैकएंड का निरीक्षण और नियंत्रण करने के लिए 86 टूल को प्रदर्शित करता है (प्रोजेक्ट कुंजी के साथ 82)। यह आपकी मशीन पर दो मोड में से एक में चलता है:
- stdio मोड (डिफ़ॉल्ट): आपका MCP क्लाइंट सर्वर को
npxके साथ उपप्रोसेस के रूप में प्रारंभ करता है। - HTTP मोड (स्ट्रीमयोग्य HTTP): आप एक स्थानीय सर्वर (
http://127.0.0.1:3001/mcp) प्रारंभ करते हैं और प्रत्येक क्लाइंट को उसके URL पर इंगित करते हैं।
होस्ट की गई सेवा (https://mcp.aurabase.dev/mcp, OAuth 2.1 के साथ साइन-इन) की योजना बनाई गई है, अभी तक लाइव नहीं हुई है।
पैकेज में दो बाइनरी (aurabase-mcp और aurabase-mcp-hosted) हैं, इसलिए npx को बाइनरी नाम की आवश्यकता है: npx -y -p @aurabase/mcp-server aurabase-mcp। --project-id आवश्यक है.
npx -y -p @aurabase/mcp-server aurabase-mcp \
--url https://<slug>.aurabase.cloud \
--project-id <uuid> \
--service-role-key aura_sk_…
इसके बजाय स्थानीय HTTP सर्वर शुरू करने के लिए, ट्रांसपोर्ट, पोर्ट और टोकन जोड़ें:
npx -y -p @aurabase/mcp-server aurabase-mcp \
--transport http \
--port 3001 \
--auth-token my_secret_token \
--url http://localhost:8080 \
--project-id <uuid> \
--service-role-key aura_sk_…
प्रति क्लाइंट और प्रति मोड कॉन्फ़िगरेशन#
stdio मोड (डिफ़ॉल्ट)
कर्सर (.cursor/mcp.json), क्लाउड डेस्कटॉप (claude_desktop_config.json), विंडसर्फ (~/.codeium/windsurf/mcp_config.json), Google एंटीग्रेविटी (~/.gemini/config/mcp_config.json) और क्लाइन या रूओ कोड के साथ वीएस कोड (cline_mcp_settings.json) एक ही ब्लॉक का उपयोग करते हैं:
{
"mcpServers": {
"aurabase": {
"command": "npx",
"args": ["-y", "-p", "@aurabase/mcp-server", "aurabase-mcp"],
"env": {
"AURABASE_URL": "https://<slug>.aurabase.cloud",
"AURABASE_PROJECT_ID": "<uuid>",
"AURABASE_SERVICE_ROLE_KEY": "aura_sk_…"
}
}
}
}
स्थानीय Docker/k3d स्टैक के विरुद्ध, AURABASE_URL को http://localhost:8080 पर सेट करें।
HTTP मोड (स्थानीय सर्वर)
स्थानीय HTTP सर्वर प्रारंभ करें (ऊपर देखें), फिर उसका URL और --auth-token मान को बियरर टोकन के रूप में जोड़ें।
कर्सर - .cursor/mcp.json या ~/.cursor/mcp.json:
{
"mcpServers": {
"aurabase": {
"url": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
विंडसर्फ़ - ~/.codeium/windsurf/mcp_config.json (कुंजी serverUrl है):
{
"mcpServers": {
"aurabase": {
"serverUrl": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
जारी रखें.dev (वीएस कोड और जेटब्रेन कोडस्ट्रल के साथ) - ~/.continue/config.yaml:
models:
- name: Codestral
provider: mistral
model: codestral-latest
apiKey: MISTRAL_API_KEY
mcpServers:
- name: aurabase
url: http://127.0.0.1:3001/mcp
headers:
Authorization: Bearer my_secret_token
मिस्ट्रल एआई (एजेंट और कनेक्टर्स) एक सार्वजनिक HTTPS यूआरएल पर MCP सर्वर तक पहुंचता है: यह होस्ट की गई सेवा (https://mcp.aurabase.dev/mcp) का उपयोग करेगा, योजनाबद्ध, अभी तक लाइव नहीं हुआ है।
एक टूल बैकएंड से प्रतिक्रिया या त्रुटि लौटाता है#
कभी निर्मित मूल्य नहीं. यह नियम कोई इरादा नहीं है: इसे सीआई के प्रत्येक निष्पादन पर एक बेंच द्वारा जांचा जाता है जो एक मृत यूआरएल के खिलाफ सर्वर लॉन्च करता है और यदि मामूली उपकरण सफलतापूर्वक प्रतिक्रिया देता है तो विफल हो जाता है। प्रत्येक उपकरण एक आउटपुट स्कीमा भी घोषित करता है जिसे एसडीके प्रतिक्रिया देने से पहले मान्य करता है।
रीड-ओनली मोड (--read-only) कैटलॉग से म्यूटेशन टूल्स को हटा देता है और PostgreSQL को केवल-पढ़ने के लिए लेनदेन में SQL को निष्पादित करने का निर्देश देता है (86 के 37 टूल्स) - गारंटी इंजन से आती है, न कि केवल क्लाइंट-साइड फ़िल्टरिंग से।
झंडे और पर्यावरण चर#
--url(AURABASE_URL) — Aurabase इंस्टेंस यूआरएल--project-id(AURABASE_PROJECT_ID) — प्रोजेक्ट आईडी--service-role-key(AURABASE_SERVICE_ROLE_KEY) — व्यवस्थापक कुंजी--read-only(AURABASE_READ_ONLY) — केवल पढ़ने के टूल को उजागर करता है (86 में से 37)--allowed-tools(AURABASE_ALLOWED_TOOLS) — श्वेतसूची, अल्पविराम से अलग--destructive-policy(MCP_DESTRUCTIVE_POLICY) — विनाशकारी SQL संचालन की इंटरएक्टिव पुष्टि:elicit(डिफ़ॉल्ट),token,deny--state-key(MCP_STATE_KEY) — कुंजी (≥ 32 बाइट्स) जो मल्टी-टर्न पुष्टिकरण पर हस्ताक्षर करती है--transport—stdio(डिफ़ॉल्ट) याhttp--port— HTTP ट्रांसपोर्ट पोर्ट (डिफ़ॉल्ट 3001)--host— HTTP श्रवण इंटरफ़ेस (डिफ़ॉल्ट127.0.0.1)--auth-token(AURABASE_MCP_AUTH_TOKEN) — /mcp पर टोकन आवश्यक - http मोड में आवश्यक
डोमेन द्वारा वितरित#
82 एक साधारण परियोजना कुंजी के साथ उजागर, 4 प्रबंधन योजना के लिए आरक्षित (एपीआई कुंजी और list_all_projects - इस चैनल के बिना व्यवस्थित रूप से विफल होने वाले उपकरण से बेहतर कोई उपकरण नहीं)।
| डेटाबेस (23) | लिस्ट_टेबल्स, डिस्क्रिप्शन_टेबल, गेट_परफॉर्मेंस_एडवाइजर्स, लिस्ट_एक्सटेंशन्स, एग्जीक्यूट_एसक्यूएल, क्वेरी_टेबल, इंसर्ट_रोज़, अपडेट_रोज़, डिलीट_रोज़, कॉल_आरपीसी, जेनरेट_टाइप्स, डिफ_स्कीमा, अप्लाई_माइग्रेशन, लिस्ट_माइग्रेशन, एक्सप्लेन_क्वेरी, एनालिसिस_टेबल, गेट_डीबी_साइज, लिस्ट_एसक्यूएल_फंक्शन, क्रिएट_एसक्यूएल_फंक्शन, ड्रॉप_एसक्यूएल_फंक्शन, सूची_एसक्यूएल_ट्रिगर, क्रिएट_एसक्यूएल_ट्रिगर, ड्रॉप_एसक्यूएल_ट्रिगर |
|---|---|
| भंडारण (9) | लिस्ट_बकेट, गेट_बकेट, क्रिएट_बकेट, लिस्ट_फाइल्स, डिलीट_फाइल्स, मूव_फाइल, क्रिएट_साइन्ड_यूआरएल, अपलोड_फाइल, खाली_बकेट |
| प्रामाणिक (7) | लिस्ट_यूजर, गेट_यूजर, क्रिएट_यूजर, अपडेट_यूजर, डिलीट_यूजर, बैन_यूजर, जनरेट_लिंक |
| सूचनाएं (10) | भेजें_ईमेल, भेजें_पुश_नोटिफिकेशन, भेजें_एसएमएस, लिस्ट_नोटिफिकेशन_लॉग, गेट_नोटिफिकेशन_सेटिंग्स, अपडेट_नोटिफिकेशन_सेटिंग्स, लिस्ट_नोटिफिकेशन_टेम्प्लेट्स, क्रिएट_नोटिफिकेशन_टेम्पलेट, डिलीट_नोटिफिकेशन_टेम्पलेट, गेट_नोटिफिकेशन_स्टैट्स |
| बैकअप (5) | सूची_बैकअप, क्रिएट_बैकअप, रिस्टोर_बैकअप, गेट_बैकअप_शेड्यूल, सेट_बैकअप_शेड्यूल |
| Edge Functions (6) | इनवोक_फंक्शन, लिस्ट_फंक्शन, गेट_फंक्शन_इन्फो, डिप्लॉय_फंक्शन, डिलीट_फंक्शन, सेट_फंक्शन_एनवी |
| RLS (6) | list_rls_policies, create_rls_policy, update_rls_policy, ड्रॉप_rls_policy, टॉगल_rls, get_security_advisors |
| ऐ (5) | इंडेक्स_डॉक्यूमेंट, रैग_क्वेरी, वेक्टर_सर्च, क्रिएट_वेक्टर_इंडेक्स, एआई_कम्प्लीशन |
| अवलोकनीयता (4) | get_project_metrics, list_slow_queries, list_active_queries, cancel_query |
| रीयलटाइम (3) | list_realtime_channels, get_realtime_settings, update_realtime_settings |
| परियोजना (4) | प्रोजेक्ट_इन्फो, स्विच_प्रोजेक्ट, गेट_एक्टिव_प्रोजेक्ट, लिस्ट_ऑल_प्रोजेक्ट्स (प्रबंधन चैनल) |
| एपीआई कुंजियाँ (3) | create_api_key, list_api_keys, revoke_api_key (प्रबंधन चैनल) |
| दस्तावेज़ीकरण (1) | search_docs - एम्बेडेड दस्तावेज़ में खोजें (अंग्रेजी) |
*_sql_function / *_sql_trigger उपकरण प्रोजेक्ट स्कीमा में संग्रहीत वास्तविक PostgreSQL फ़ंक्शन और ट्रिगर बनाते हैं - list_functions / deploy_function (Edge Functions WASM, एक अलग रनटाइम) से असंबंधित।
यूआरएल से जुड़ने वाले ग्राहकों के लिए HTTP मोड#
stdio डिफ़ॉल्ट परिवहन है। http मोड (स्ट्रीम करने योग्य HTTP, MCP प्रोटोकॉल 2025-11-25 और 2026-07-28):
- डिफ़ॉल्ट रूप से
127.0.0.1पर सुनता है (इसे बदलने के लिए--host); - एक टोकन की आवश्यकता है (
--auth-tokenया बियरर टोकन) - इसके बिना, सर्वर प्रारंभ करने से इंकार कर देता है; Originहेडर को मान्य करता है और अनधिकृत उत्पत्ति (एंटी-सीएसआरएफ सुरक्षा) पर 403 का जवाब देता है;- प्रति सत्र एक सर्वर इंस्टेंस, समाप्ति और कॉन्फ़िगर करने योग्य सीमा के साथ;
- निरंतर समय और सीमा अनुरोध बॉडी आकार में टोकन की तुलना करता है।