Aiven

Aiven MCP सर्वर

Aiven क्लाउड डेटा प्लेटफ़ॉर्म के लिए एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर।

Claude, Cursor और VS Code Copilot जैसे AI सहायकों से सीधे PostgreSQL, Apache Kafka, एप्लिकेशन और अन्य Aiven सेवाओं का प्रबंधन करें।

[!WARNING] सावधानी से उपयोग करें। यह MCP सर्वर आपकी ओर से Aiven सेवाओं और डेटा को बना, संशोधित और हटा सकता है। AI एजेंट आपके संकेतों की अपनी व्याख्या के आधार पर विनाशकारी कार्रवाइयाँ (डेटाबेस छोड़ना, सेवाएँ हटाना, संदेश उत्पन्न करना) निष्पादित कर सकते हैं। इस उपकरण के माध्यम से की गई कार्रवाइयों के लिए आप पूरी तरह से जिम्मेदार हैं।

अनुमतियाँ: पहुँच प्रमाणित खाते से जुड़ी Aiven उपयोगकर्ता अनुमतियों द्वारा नियंत्रित होती है। MCP सर्वर केवल वही कार्य कर सकता है जो आपके Aiven उपयोगकर्ता को करने की अनुमति है।

AI एजेंट सुरक्षा: AI एजेंटों को आपकी ओर से कार्य करने के लिए पहुँच क्रेडेंशियल्स (डेटाबेस कनेक्शन स्ट्रिंग, स्ट्रीमिंग टोकन) की आवश्यकता हो सकती है। समीक्षा करें कि आपका एजेंट क्या कर रहा है, विशेष रूप से उत्पादन परिवेशों में। अपने संगठन की सुरक्षा नीतियों का पालन करें और AI एजेंटों को संवेदनशील संसाधनों तक पहुँच देने से पहले जोखिम मूल्यांकन करें।

त्वरित शुरुआत

विकल्प 1: रिमोट (Aiven द्वारा होस्ट किया गया)

MCP सर्वर https://mcp.aiven.live/mcp पर होस्ट किया गया है। आपका MCP क्लाइंट आपको Aiven पर अधिकृत करने के लिए संकेत देगा।

Claude Code

claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp"

Cursor

या मैन्युअल रूप से Cursor MCP सेटिंग्स में जोड़ें:

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp"
    }
  }
}

VS Code / Copilot

अपने कार्यक्षेत्र में .vscode/mcp.json में जोड़ें:

{
  "servers": {
    "aiven-mcp": {
      "type": "http",
      "url": "https://mcp.aiven.live/mcp"
    }
  }
}

केवल-पढ़ने का मोड (रिमोट)

URL में ?read_only=true जोड़कर केवल-पढ़ने का मोड सक्षम करें। सभी लेखन कार्य MCP से बाहर रखे जाएँगे:

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp?read_only=true"
    }
  }
}

स्कोप्ड टूल्स (रिमोट)

URL में ?services_scope= जोड़कर अपने AI एजेंट के सामने आने वाली टूल सतह को कम करें। उपयोगी जब आप केवल Aiven सेवाओं के एक उपसमूह के साथ काम करते हैं और एजेंट के संदर्भ को केंद्रित रखना चाहते हैं। मानों को अल्पविराम से संयोजित करें। core (प्रोजेक्ट/सेवा खोज) हमेशा अंतर्निहित रूप से शामिल होता है।

मान्य स्कोप: all, core, pg, kafka, application, integrations। हर उपकरण को स्पष्ट रूप से लोड करने के लिए all का उपयोग करें (पैरामीटर छोड़ने के समान)। all को अन्य स्कोप के साथ संयोजित नहीं किया जा सकता।

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp?services_scope=kafka"
    }
  }
}

आप read_only के साथ भी संयोजित कर सकते हैं:

https://mcp.aiven.live/mcp?services_scope=pg&read_only=true

केवल-पढ़ने के मोड में लेखन अपवाद (रिमोट)

जब read_only=true, तो विशिष्ट लेखन उपकरणों को पुनः सक्षम करने के लिए ?write_allowlist= जोड़ें जबकि बाकी सब कुछ केवल-पढ़ने के लिए रखें। उपयोगी जब आप अधिकतर-पढ़ने की पहुँच चाहते हैं लेकिन फिर भी एक लेखन कार्रवाई की अनुमति देना चाहते हैं, उदाहरण के लिए Kafka टॉपिक बनाना। एकाधिक उपकरण नामों को अल्पविराम से संयोजित करें। जब read_only सक्षम नहीं है तो अनदेखा किया जाता है।

https://mcp.aiven.live/mcp?read_only=true&write_allowlist=aiven_kafka_topic_create

मार्केटप्लेस ग्राहक (रिमोट)

यदि आपने क्लाउड मार्केटप्लेस के माध्यम से Aiven की सदस्यता ली है, तो अपने मार्केटप्लेस को पथ खंड के रूप में जोड़ें ताकि साइन-इन सही कंसोल का उपयोग करे:

मार्केटप्लेस	पथ खंड
AWS मार्केटप्लेस	https://mcp.aiven.live/mcp/aws
Azure मार्केटप्लेस	https://mcp.aiven.live/mcp/azure
Google Cloud मार्केटप्लेस	https://mcp.aiven.live/mcp/gcp

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp/<marketplace>"
    }
  }
}

पथ खंड उपरोक्त क्वेरी पैरामीटर के साथ संयोजित होता है, उदाहरण के लिए https://mcp.aiven.live/mcp/gcp?services_scope=pg&read_only=true।

विकल्प 2: stdio (स्थानीय)

अपने MCP क्लाइंट की चाइल्ड प्रक्रिया के रूप में सर्वर को स्थानीय रूप से चलाएँ। Node.js 18+ की आवश्यकता है।

आपको AIVEN_TOKEN पर्यावरण चर के माध्यम से अपना Aiven API टोकन प्रदान करना होगा। यहाँ एक टोकन बनाएँ।

Claude Code

claude mcp add --scope user aiven-mcp -e AIVEN_TOKEN=your-token-here -- npx -y mcp-aiven

Cursor, VS Code -- अपने MCP क्लाइंट कॉन्फ़िग में जोड़ें:

{
  "mcpServers": {
    "aiven-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-aiven"],
      "env": {
        "AIVEN_TOKEN": "your-token-here"
      }
    }
  }
}

कॉन्फ़िग फ़ाइल स्थान:

• Cursor: Cursor सेटिंग्स > MCP सर्वर
• VS Code: आपके कार्यक्षेत्र में .vscode/mcp.json

विकल्प 3: स्थानीय विकास

सर्वर का एक स्थानीय बिल्ड चलाएँ (विकास और परीक्षण के लिए उपयोगी):

pnpm install && pnpm generate:api-types && pnpm generate && pnpm build && AIVEN_TOKEN="<YOUR_TOKEN>" MCP_TRANSPORT="http" PORT=3000 node dist/index.js

सर्वर डिफ़ॉल्ट रूप से पोर्ट 3000 पर सुनता है। अपने MCP क्लाइंट को http://localhost:3000/mcp से कनेक्ट करें।

किसी कस्टम होस्ट (जैसे आपका स्थानीय बिल्ड) पर रिमोट डिप्लॉयमेंट को इंगित करने के लिए, MCP_HOST सेट करें:

MCP_HOST=http://localhost:3000 node dist/index.js

पर्यावरण चर

चर	आवश्यक	डिफ़ॉल्ट	विवरण
AIVEN_TOKEN	केवल stdio	--	Aiven API टोकन (यहाँ एक बनाएँ)
AIVEN_READ_ONLY	नहीं	false	केवल-पढ़ने के उपकरणों को उजागर करने के लिए true पर सेट करें
AIVEN_SERVICES_SCOPE	नहीं	--	उजागर करने के लिए अल्पविराम-पृथक स्कोप (जैसे kafka, pg,kafka, या all)। मान्य: all, core, pg, kafka, application, integrations। core हमेशा शामिल होता है। चर छोड़ने या all सेट करने पर हर उपकरण लोड होता है।
AIVEN_ALLOW_SECRETS	नहीं	false	aiven_service_connection_info उपकरण को उजागर करने के लिए true पर सेट करें, जो बातचीत में लाइव क्रेडेंशियल्स (पासवर्ड, कनेक्शन URI, प्रमाणपत्र) लौटाता है। AIVEN_READ_ONLY=true के दौरान अक्षम।
AIVEN_WRITE_ALLOWLIST	नहीं	--	AIVEN_READ_ONLY=true के दौरान पुनः सक्षम करने के लिए अल्पविराम-पृथक उपकरण नाम (जैसे aiven_kafka_topic_create)। जब केवल-पढ़ने का मोड सक्षम नहीं है तो अनदेखा किया जाता है।
MCP_HOST	नहीं	https://mcp.aiven.live	OAuth संरक्षित संसाधन होस्ट को ओवरराइड करें
MCP_TRANSPORT	नहीं	stdio	stdio के बजाय HTTP सर्वर शुरू करने के लिए http पर सेट करें
MCP_HTTP_RATE_LIMIT_MAX	नहीं	1000	POST /mcp (HTTP ट्रांसपोर्ट) पर प्रति बियरर टोकन, प्रति विंडो अधिकतम अनुरोध। क्लाइंट IP दर सीमित करना Cloudflare पर अपेक्षित है।
MCP_HTTP_RATE_LIMIT_WINDOW_MS	नहीं	60000	MCP_HTTP_RATE_LIMIT_MAX के लिए मिलीसेकंड में विंडो लंबाई।
EXTRA_PROTECTION	नहीं	false	GET /health को छोड़कर हर अनुरोध पर मान्य X-Edge-Auth हेडर की आवश्यकता के लिए HTTP डिप्लॉयमेंट पर true पर सेट करें। नीचे एज सुरक्षा रोलआउट देखें।
MCP_EDGE_AUTH_SECRET	जब EXTRA_PROTECTION=true	--	साझा रहस्य; उस मान से मेल खाना चाहिए जिसे Cloudflare ट्रांसफ़ॉर्म नियमों के माध्यम से X-Edge-Auth के रूप में इंजेक्ट करता है।

रिमोट (HTTP) मोड में, AIVEN_TOKEN की आवश्यकता नहीं है। आपका MCP क्लाइंट प्रत्येक अनुरोध के साथ आपके टोकन को बियरर टोकन के रूप में भेजता है।

उत्पादन HTTP ट्रैफ़िक दो परतों में दर-सीमित है: Cloudflare प्रति-क्लाइंट-IP सीमा लागू करता है (Cloudflare डैशबोर्ड में कॉन्फ़िगर किया गया), और यह सर्वर POST /mcp पर प्रति बियरर टोकन MCP_HTTP_RATE_LIMIT_* लागू करता है।

एज सुरक्षा रोलआउट

जब EXTRA_PROTECTION=true, MCP_EDGE_AUTH_SECRET और Cloudflare द्वारा X-Edge-Auth के रूप में इंजेक्ट किए गए मान के बीच कोई भी बेमेल हर अनुरोध को 403 लौटाने का कारण बनता है (GET /health को छोड़कर)। दोनों मान तार के विपरीत पक्षों पर पर्यावरण/कॉन्फ़िग हैं, इसलिए एकमात्र पुनर्प्राप्ति पथ रहस्य को ठीक करना और पुनः तैनात करना या Cloudflare को अपडेट करना है।

इस क्रम में सक्षम करें:

1. Cloudflare ट्रांसफ़ॉर्म नियम — एक नियम जोड़ें जो MCP ओरिजिन के ट्रैफ़िक पर X-Edge-Auth (और, यदि PG उपकरणों के लिए उपयोग किया जाता है, X-Client-IP) सेट करता है। आपके द्वारा कॉन्फ़िगर किए गए गुप्त मान को नोट करें।
2. MCP_EDGE_AUTH_SECRET — इस एन्व वेरिएबल को ट्रांसफ़ॉर्म नियम के समान रहस्य पर सेट करके सर्वर तैनात करें। अभी के लिए EXTRA_PROTECTION को अनसेट या false छोड़ दें; सत्यापित करें कि ओरिजिन अभी भी ट्रैफ़िक स्वीकार करता है।
3. EXTRA_PROTECTION=true — केवल तभी सक्षम करें जब चरण 1–2 लाइव और मिलान हो जाएँ। पुष्टि करें कि एक सामान्य MCP अनुरोध सफल होता है और X-Edge-Auth के बिना सीधी ओरिजिन पहुँच अस्वीकृत हो जाती है।
4. गुप्त रोटेशन — Cloudflare और MCP_EDGE_AUTH_SECRET को एक साथ अपडेट करें (या संक्षेप में EXTRA_PROTECTION=false सेट करें), पुनः तैनात करें, फिर पुनः सक्षम करें। फ़्लैग चालू होने पर कभी भी अकेले एक पक्ष को रोटेट न करें।

यदि स्टार्टअप पर EXTRA_PROTECTION=true और MCP_EDGE_AUTH_SECRET गायब है, तो प्रक्रिया तुरंत एक त्रुटि के साथ बाहर निकल जाती है।

जबकि अस्वीकृतियाँ जारी रहती हैं, सर्वर हर 15 मिनट में अधिकतम एक बार एक गलत कॉन्फ़िगरेशन चेतावनी लॉग करता है (मान्य X-Edge-Auth के साथ अनुरोध के बाद रीसेट), ताकि प्रति अस्वीकृत अनुरोध एक पंक्ति के बिना लॉग में एक गुप्त बेमेल दिखाई दे।

उपकरण

मुख्य

उपकरण	विवरण
aiven_project_list	प्रोजेक्ट सूचीबद्ध करें
aiven_project_get	प्रोजेक्ट विवरण प्राप्त करें
aiven_list_project_clouds	किसी प्रोजेक्ट के लिए क्लाउड प्लेटफ़ॉर्म सूचीबद्ध करें
aiven_project_vpc_list	किसी प्रोजेक्ट के लिए VPC सूचीबद्ध करें
aiven_service_list	सेवाएँ सूचीबद्ध करें
aiven_service_type_plans	क्लाउड उपलब्धता के साथ योजनाएँ सूचीबद्ध करें
aiven_service_plan_pricing	किसी विशिष्ट क्लाउड में योजना के लिए मूल्य निर्धारण प्राप्त करें
aiven_service_create	एक सेवा बनाएँ
aiven_service_get	सेवा जानकारी प्राप्त करें
aiven_service_update	एक सेवा अपडेट करें (योजना, कॉन्फ़िग, पावर स्थिति)
aiven_service_metrics_fetch	प्रबंधित डेटा सेवाओं के लिए मीट्रिक्स प्राप्त करें
aiven_service_application_metrics_get	अनुप्रयोग सेवाओं के लिए मीट्रिक्स प्राप्त करें
aiven_project_get_service_logs	सेवा लॉग प्रविष्टियाँ प्राप्त करें
aiven_service_query_activity	किसी सेवा के लिए वर्तमान क्वेरीज़ प्राप्त करें
aiven_project_get_event_logs	प्रोजेक्ट ईवेंट लॉग प्रविष्टियाँ प्राप्त करें

Kafka

उपकरण	विवरण
aiven_kafka_topic_list	Kafka टॉपिक सूचीबद्ध करें
aiven_kafka_topic_create	एक Kafka टॉपिक बनाएँ
aiven_kafka_topic_get	Kafka टॉपिक जानकारी प्राप्त करें
aiven_kafka_topic_update	एक Kafka टॉपिक अपडेट करें
aiven_kafka_topic_delete	एक Kafka टॉपिक हटाएँ
aiven_kafka_topic_message_list	Kafka टॉपिक से संदेश पढ़ें
aiven_kafka_topic_message_produce	Kafka टॉपिक में संदेश उत्पन्न करें
aiven_kafka_connect_available_connectors	उपलब्ध कनेक्टर प्रकार सूचीबद्ध करें
aiven_kafka_connect_list	चल रहे कनेक्टर सूचीबद्ध करें
aiven_kafka_connect_create_connector	एक कनेक्टर बनाएँ
aiven_kafka_connect_edit_connector	एक कनेक्टर संपादित करें
aiven_kafka_connect_get_connector_status	कनेक्टर स्थिति प्राप्त करें
aiven_kafka_connect_pause_connector	एक कनेक्टर रोकें
aiven_kafka_connect_resume_connector	एक कनेक्टर फिर से शुरू करें
aiven_kafka_connect_restart_connector	एक कनेक्टर पुनः आरंभ करें
aiven_kafka_connect_delete_connector	एक कनेक्टर हटाएँ
aiven_kafka_schema_registry_subjects	स्कीमा रजिस्ट्री विषय सूचीबद्ध करें
aiven_kafka_schema_registry_subject_version_get	स्कीमा रजिस्ट्री विषय संस्करण प्राप्त करें

PostgreSQL

उपकरण	विवरण
aiven_pg_service_available_extensions	उपलब्ध एक्सटेंशन सूचीबद्ध करें
aiven_pg_service_query_statistics	क्वेरी आँकड़े प्राप्त करें
aiven_pg_bouncer_create	एक PgBouncer कनेक्शन पूल बनाएँ
aiven_pg_bouncer_update	एक PgBouncer कनेक्शन पूल अपडेट करें
aiven_pg_bouncer_delete	एक PgBouncer कनेक्शन पूल हटाएँ
aiven_pg_read	एक केवल-पढ़ने की SQL क्वेरी चलाएँ
aiven_pg_write	एक लेखन SQL कथन चलाएँ (INSERT, UPDATE, DELETE, CREATE TABLE, आदि)
aiven_pg_optimize_query	AI-संचालित क्वेरी अनुकूलन (EverSQL)

अनुप्रयोग

उपकरण	विवरण
aiven_application_deploy	Aiven पर एक Dockerized अनुप्रयोग तैनात करें
aiven_application_redeploy	किसी मौजूदा अनुप्रयोग का पुनर्निर्माण और पुनः तैनाती करें
aiven_vcs_integration_list	जुड़े हुए VCS (GitHub) खाते सूचीबद्ध करें
aiven_vcs_integration_repository_list	VCS एकीकरण के लिए रिपॉजिटरी सूचीबद्ध करें

दस्तावेज़ीकरण

उपकरण	विवरण
aiven_docs_search	प्राकृतिक भाषा में आधिकारिक Aiven दस्तावेज़ीकरण खोजें। केवल होस्टेड सर्वर (https://mcp.aiven.live/mcp) पर उपलब्ध — स्व-होस्टेड तैनाती में उजागर नहीं।

योगदान

विकास सेटअप, स्थानीय रूप से चलाने और नए उपकरण जोड़ने के लिए CONTRIBUTING.md देखें।

लाइसेंस

Apache-2.0