Aiven

आधिकारिक

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

GitHub

इस MCP को आज़माएँप्रायोजित

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

Aiven सेवाएँ प्रबंधित करें — अपने सहायक से aiven_service_create, aiven_service_update, और aiven_service_list के माध्यम से सेवाओं की सूची बनाने, बनाने, अपडेट करने या हटाने के लिए कहें।
Kafka टॉपिक्स के साथ काम करें — अपने सहायक से aiven_kafka_topic_create और aiven_kafka_topic_message_produce का उपयोग करके टॉपिक्स बनाने, पढ़ने या संदेश उत्पन्न करने के लिए कहें।
PostgreSQL क्वेरी चलाएँ — अपने सहायक को aiven_pg_read और aiven_pg_write के साथ केवल-पढ़ने या लिखने वाले SQL स्टेटमेंट निष्पादित करने दें, या aiven_pg_optimize_query के माध्यम से क्वेरी अनुकूलित करें।
Kafka कनेक्टर प्रबंधित करें — अपने सहायक से aiven_kafka_connect_create_connector और संबंधित टूल का उपयोग करके कनेक्टर बनाने, रोकने, फिर से शुरू करने या हटाने के लिए कहें।
एप्लिकेशन तैनात करें — अपने सहायक से aiven_application_create और aiven_application_redeploy के साथ रिपॉजिटरी से एप्लिकेशन बनाने या फिर से तैनात करने के लिए कहें।
Aiven दस्तावेज़ खोजें — अपने सहायक से aiven_docs_search (केवल होस्टेड सर्वर) का उपयोग करके आधिकारिक दस्तावेज़ों में उत्तर खोजने के लिए कहें।

दस्तावेज़

Aiven MCP सर्वर

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

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

[!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`	`true` पर सेट करें ताकि `aiven_service_connection_info` टूल उजागर हो, जो लाइव क्रेडेंशियल (पासवर्ड, कनेक्शन 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`	HTTP डिप्लॉयमेंट पर `true` पर सेट करें ताकि `GET /health` को छोड़कर हर अनुरोध पर मान्य `X-Edge-Auth` हेडर की आवश्यकता हो। नीचे एज सुरक्षा रोलआउट देखें।
`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 को अपडेट करना है।

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

Cloudflare ट्रांसफॉर्म नियम — एक नियम जोड़ें जो MCP ओरिजिन पर ट्रैफ़िक पर X-Edge-Auth (और, यदि PG टूल्स के लिए उपयोग किया जाता है, X-Client-IP) सेट करता है। आपके द्वारा कॉन्फ़िगर किया गया रहस्य मान नोट करें।
MCP_EDGE_AUTH_SECRET — सर्वर को इस env var के साथ ट्रांसफॉर्म नियम के समान रहस्य पर सेट करके तैनात करें। अभी के लिए 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_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_create`	Containerfile/Dockerfile एप्लिकेशन बनाएं और प्रारंभ में तैनात करें; यदि सेवा पहले से मौजूद है तो 409 लौटाता है
`aiven_application_redeploy`	सेवा कॉन्फ़िगरेशन बदले बिना कॉन्फ़िगर किए गए रिपॉजिटरी से मौजूदा एप्लिकेशन को फिर से बनाएं
`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