Aiven

आधिकारिक

अपने Aiven प्रोजेक्ट्स को नेविगेट करें और PostgreSQL®, Apache Kafka®, ClickHouse® तथा OpenSearch® सेवाओं के साथ इंटरैक्ट करें

GitHub

Aiven MCP के साथ आप क्या कर सकते हैं?

Aiven सेवाओं को प्रबंधित करें — अपने प्रोजेक्ट्स में PostgreSQL, Kafka और अन्य Aiven सेवाओं के लिए सूची बनाएँ, बनाएँ, अपडेट करें, और विवरण या मेट्रिक्स प्राप्त करें।
Kafka के साथ काम करें — टॉपिक्स की सूची बनाएँ, बनाएँ, अपडेट करें और हटाएँ, संदेश पढ़ें या उत्पन्न करें, और Kafka Connect कनेक्टर्स तथा Schema Registry विषयों को प्रबंधित करें।
PostgreSQL क्वेरी चलाएँ — केवल-पढ़ने वाली SQL क्वेरी या लेखन कथन निष्पादित करें, क्वेरी आँकड़े प्राप्त करें, और PgBouncer कनेक्शन पूल प्रबंधित करें।
एप्लिकेशन तैनात करें — Containerfile/Dockerfile एप्लिकेशन बनाएँ और पुनः तैनात करें तथा VCS इंटीग्रेशन के माध्यम से GitHub रिपॉज़िटरी कनेक्ट करें।
Aiven दस्तावेज़ खोजें — आधिकारिक Aiven दस्तावेज़ों को प्राकृतिक भाषा में खोजें (केवल होस्टेड सर्वर)।
पहुँच प्रतिबंधित करें — केवल-पढ़ने का मोड सक्षम करें, टूल्स को विशिष्ट सेवा प्रकारों तक सीमित करें, या व्यक्तिगत राइट टूल्स को allowlist करें।

दस्तावेज़

Aiven MCP सर्वर

Aiven क्लाउड डेटा प्लेटफ़ॉर्म के लिए एक Model Context Protocol (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, opensearch। प्रत्येक टूल को स्पष्ट रूप से लोड करने के लिए all का उपयोग करें (पैरामीटर छोड़ने के समान)। all को अन्य स्कोप के साथ संयोजित नहीं किया जा सकता। opensearch kafka या pg के समान नियमों का पालन करता है (कोर प्लस OpenSearch-श्रेणी के टूल); अभी तक कोई OpenSearch-विशिष्ट टूल नहीं हैं, इसलिए यह वर्तमान में केवल कोर उजागर करता है।

{
  "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 Marketplace	`https://mcp.aiven.live/mcp/aws`
Azure Marketplace	`https://mcp.aiven.live/mcp/azure`
Google Cloud Marketplace	`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 Settings > MCP Servers
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`, `opensearch`। स्कोप्ड सेवा प्रकारों के लिए `core` अंतर्निहित रूप से शामिल है। `opensearch` में अभी तक कोई समर्पित टूल नहीं है (OpenSearch टूल जोड़े जाने तक केवल कोर)। चर को छोड़ने या `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 द्वारा Transform Rules के माध्यम से `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 को अपडेट करना है।

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

Cloudflare Transform Rule — एक नियम जोड़ें जो MCP ओरिजिन पर ट्रैफ़िक पर X-Edge-Auth (और, यदि PG टूल के लिए उपयोग किया जाता है, तो X-Client-IP) सेट करता है। आप जो गुप्त मान कॉन्फ़िगर करते हैं उसे नोट करें।
MCP_EDGE_AUTH_SECRET — सर्वर को इस पर्यावरण चर के साथ Transform Rule के समान गुप्त पर सेट करके डिप्लॉय करें। अभी के लिए EXTRA_PROTECTION को अनसेट या false छोड़ दें; सत्यापित करें कि ओरिजिन अभी भी ट्रैफ़िक स्वीकार करता है।
EXTRA_PROTECTION=true — केवल तब सक्षम करें जब चरण 1–2 लाइव और मेल खाते हों। पुष्टि करें कि एक सामान्य MCP अनुरोध सफल होता है और X-Edge-Auth के बिना सीधी ओरिजिन पहुँच अस्वीकार की जाती है।
गुप्त रोटेशन — 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_type_get`	सेवा प्रकार के लिए डिफ़ॉल्ट और उपलब्ध इंजन संस्करण प्राप्त करें
`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`	Schema Registry विषय सूचीबद्ध करें
`aiven_kafka_schema_registry_subject_version_get`	Schema Registry विषय संस्करण प्राप्त करें

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_create`	एक Containerfile/Dockerfile एप्लिकेशन बनाएँ और प्रारंभ में डिप्लॉय करें; यदि सेवा पहले से मौजूद है तो 409 लौटाता है
`aiven_application_redeploy`	सेवा कॉन्फ़िगरेशन बदले बिना इसके कॉन्फ़िगर किए गए रिपॉज़िटरी से मौजूदा एप्लिकेशन को पुनः बिल्ड करें
`aiven_vcs_integration_initialize`	GitHub खाते को कनेक्ट करने के लिए ब्राउज़र-आधारित प्रवाह शुरू करें
`aiven_vcs_integration_list`	कनेक्टेड VCS (GitHub) खाते सूचीबद्ध करें
`aiven_vcs_integration_repository_list`	VCS एकीकरण के लिए रिपॉज़िटरी सूचीबद्ध करें
`aiven_vcs_integration_repository_branch_list`	रिपॉज़िटरी शाखाएँ और उनके वर्तमान कमिट SHA सूचीबद्ध करें
`aiven_vcs_integration_repository_container_manifest_files_list`	उम्मीदवार Containerfile, Dockerfile, और Compose मैनिफ़ेस्ट खोजें
`aiven_vcs_integration_repository_scan_container_manifest`	Containerfile, Dockerfile, या Compose फ़ाइल के समर्थित भागों से उम्मीदवार Aiven सेवा कॉन्फ़िगरेशन प्राप्त करें

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

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

योगदान

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

लाइसेंस

Apache-2.0