amCharts 5 MCP Server

amCharts 5 MCP Server

एक MCP (Model Context Protocol) सर्वर जो AI सहायकों को संपूर्ण amCharts 5 ज्ञानकोश तक ऑन-डिमांड पहुँच प्रदान करता है: 160+ दस्तावेज़ पृष्ठ, 290+ कोड उदाहरण, और 1,300+ API संदर्भ पृष्ठ।

यह Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + GitHub Copilot, और किसी भी अन्य MCP-संगत AI टूल के साथ काम करता है।

क्यों?

पूरे amCharts संदर्भ को AI के context window में लोड करने के बजाय, MCP सर्वर AI को ठीक वही क्वेरी करने देता है जो उसे चाहिए — किसी विशिष्ट चार्ट प्रकार का संदर्भ, एक कोड उदाहरण, या एक API लुकअप। इसका मतलब है कम context बर्बादी के साथ बेहतर उत्तर।

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

सबसे आसान तरीका होस्टेड सर्वर है — कोई इंस्टॉल नहीं, बस एक URL जोड़ें। खुद चलाना पसंद करते हैं? नीचे लोकल इंस्टॉल देखें।

होस्टेड (कोई इंस्टॉल नहीं) — अनुशंसित

अपने AI क्लाइंट को यहाँ इंगित करें:

https://mcp.amcharts.com/mcp

Claude Code

claude mcp add --transport http amcharts5 https://mcp.amcharts.com/mcp

Claude Desktop / claude.ai — Settings → Connectors → Add custom connector, फिर https://mcp.amcharts.com/mcp पेस्ट करें।

Cursor — .cursor/mcp.json:

{
  "mcpServers": {
    "amcharts5": {
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

VS Code + GitHub Copilot — .vscode/mcp.json:

{
  "servers": {
    "amcharts5": {
      "type": "http",
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "amcharts5": {
      "serverUrl": "https://mcp.amcharts.com/mcp"
    }
  }
}

ChatGPT (connectors/developer mode सक्षम के साथ Plus/Pro/Enterprise) — Settings → Connectors → Add custom connector, फिर https://mcp.amcharts.com/mcp पेस्ट करें।

Cline (VS Code एक्सटेंशन) — MCP Servers पैनल खोलें → Remote Servers, https://mcp.amcharts.com/mcp पेस्ट करें, या इसकी MCP settings JSON में जोड़ें:

{
  "mcpServers": {
    "amcharts5": {
      "type": "streamableHttp",
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

केवल लोकल (stdio) सर्वर समर्थित करने वाले क्लाइंट (जैसे Zed, Continue, Amazon Q Developer) — mcp-remote के साथ होस्टेड URL से ब्रिज करें। क्लाइंट की कॉन्फ़िग में सर्वर के run command के रूप में इसे उपयोग करें:

npx mcp-remote https://mcp.amcharts.com/mcp

उदाहरण के लिए, command/args शैली की कॉन्फ़िग में:

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.amcharts.com/mcp"]
    }
  }
}

कोई भी अन्य MCP क्लाइंट जो रिमोट सर्वर URL स्वीकार करता है, वह भी काम करेगा — /mcp endpoint (Streamable HTTP) या /sse (legacy SSE) का उपयोग करें। उन URL-only क्लाइंट के लिए जो अभी भी किसी command की अपेक्षा करते हैं, ऊपर दिखाया गया mcp-remote ब्रिज उपयोग करें।

लोकल इंस्टॉल (npx)

खुद चलाना पसंद करते हैं? सर्वर npm पर भी प्रकाशित है और stdio पर चलता है।

Claude Code

सभी प्रोजेक्ट्स के लिए (ग्लोबल, अनुशंसित):

claude mcp add -s user amcharts5 -- npx -y @amcharts/amcharts5-mcp

केवल वर्तमान प्रोजेक्ट के लिए:

claude mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcp

Claude Desktop

अपने claude_desktop_config.json में जोड़ें:

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

Cursor

अपने प्रोजेक्ट रूट में .cursor/mcp.json बनाएँ या संपादित करें (या ग्लोबल के लिए ~/.cursor/mcp.json):

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json संपादित करें:

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

VS Code + GitHub Copilot

अपने वर्कस्पेस में .vscode/mcp.json बनाएँ या संपादित करें:

{
  "servers": {
    "amcharts5": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

अन्य MCP-संगत टूल

किसी भी अन्य टूल के लिए जो MCP समर्थित करता है (Cline, Continue, Amazon Q, Zed, आदि), इसे चलाने के लिए कॉन्फ़िगर करें:

npx -y @amcharts/amcharts5-mcp

लोकल रूप से चलाएँ (विकास के लिए)

git clone https://github.com/amcharts/amcharts5-mcp.git
cd amcharts5-mcp
npm install
npm start

उपलब्ध टूल

टूल	विवरण
get_core_reference	मुख्य amCharts 5 दस्तावेज़ प्राप्त करें — सेटअप, थीम, रंग, इवेंट, सामान्य गलतियाँ
get_chart_reference	किसी चार्ट प्रकार का पूर्ण संदर्भ प्राप्त करें (जैसे "pie", "sankey", "xy")
list_chart_types	सभी उपलब्ध चार्ट प्रकार और उनके कीवर्ड सूचीबद्ध करें
search_docs	कीवर्ड द्वारा skill संदर्भ दस्तावेज़ खोजें (scope: "all" पूर्ण दस्तावेज़, API संदर्भ और उदाहरण जोड़ता है)
search_all	सब कुछ में खोजें — skill दस्तावेज़, पूर्ण दस्तावेज़ीकरण, और कोड उदाहरण
get_doc	एक पूर्ण दस्तावेज़ पृष्ठ प्राप्त करें (जैसे "charts/xy-chart/axes", "concepts/events")
get_section	हेडिंग द्वारा संदर्भ फ़ाइल से एक विशिष्ट अनुभाग प्राप्त करें
get_quick_start	किसी भी चार्ट प्रकार के लिए एक न्यूनतम कार्यशील टेम्पलेट प्राप्त करें
list_examples	सभी 290+ उदाहरण ब्राउज़ करें, वैकल्पिक रूप से श्रेणी द्वारा फ़िल्टर करें
get_example	किसी विशिष्ट उदाहरण का पूरा कोड प्राप्त करें
get_api_reference	किसी क्लास, इंटरफ़ेस या फ़ंक्शन का API संदर्भ प्राप्त करें — उनके डिफ़ॉल्ट के साथ सेटिंग्स, इवेंट, इनहेरिटेंस और import पंक्ति
list_geodata	मैप (geodata) फ़ाइलें खोजें — world, महाद्वीप, देश, क्षेत्रीय पैक और प्रति-Congress US congressional district पैक — प्रत्येक फ़ाइल के CDN पथ, script global और ES import के साथ

उदाहरण उपयोग

कनेक्ट होने के बाद, आपका AI सहायक यह कर सकता है:

• "मेरे लिए एक pie chart बनाओ" → AI get_quick_start("pie") कॉल करता है और टेम्पलेट को अनुकूलित करता है
• "मैं date axis लेबल कैसे फ़ॉर्मेट करूँ?" → AI search_all("date axis label format") कॉल करता है
• "मुझे Sankey diagram उदाहरण दिखाओ" → AI get_example("examples/flow/sankey-diagram") कॉल करता है
• "XYChart कौन-सी सेटिंग्स समर्थित करता है?" → AI get_doc("reference/xychart") कॉल करता है
• "मैं React के साथ कैसे एकीकृत करूँ?" → AI get_doc("getting-started/integrations/react") कॉल करता है, जो @amcharts/amcharts5-react पैकेज को कवर करता है
• "कौन-से चार्ट प्रकार उपलब्ध हैं?" → AI list_chart_types() कॉल करता है
• "वर्तमान US congressional districts का मैप बनाओ" → AI list_geodata("congressional whole country") कॉल करता है

सामग्री

सर्वर में 1,800+ दस्तावेज़ शामिल हैं:

• 160+ दस्तावेज़ पृष्ठ — शुरुआत करना, चार्ट गाइड, अवधारणाएँ (थीम, इवेंट, adapters, data binding, एनिमेशन, accessibility, आदि), और amCharts के React, Vue, Angular, Svelte और React Native पैकेज के लिए फ़्रेमवर्क एकीकरण गाइड (Next.js, Nuxt, SvelteKit, React Router और Remix 3 के साथ)
• 290+ कोड उदाहरण — 16 श्रेणियों में कार्यशील डेमो, जिनमें column/bar, line/area, pie/donut, maps, hierarchy, flow, radar/polar, stock, gauges, Gantt, timeline, और अधिक शामिल हैं
• 1,300+ API संदर्भ पृष्ठ — amCharts 5 लाइब्रेरी में प्रत्येक क्लास, इंटरफ़ेस और फ़ंक्शन, रिलीज़ की typings से उत्पन्न: उनके वास्तविक डिफ़ॉल्ट के साथ सेटिंग्स (थीम नियम सहित), इवेंट, प्रॉपर्टीज़, data item फ़ील्ड, इनहेरिटेंस श्रृंखला और import पंक्ति
• 670+ geodata प्रविष्टियाँ — @amcharts/amcharts5-geodata में प्रत्येक मैप, list_geodata के लिए
• क्यूरेटेड skill संदर्भ — amCharts 5 AI Skill से त्वरित-शुरुआत टेम्पलेट और चार्ट-विशिष्ट गाइड

सुरक्षा

• केवल-पढ़ने वाले टूल। प्रत्येक टूल बंडल किए गए amCharts दस्तावेज़ीकरण को पढ़ता है और टेक्स्ट लौटाता है। कोई भी टूल फ़ाइलें नहीं लिखता, कमांड नहीं चलाता या URL नहीं फ़ेच करता।
• होस्टेड endpoint में डिज़ाइन के अनुसार कोई प्रमाणीकरण नहीं है। https://mcp.amcharts.com/mcp वही सार्वजनिक दस्तावेज़ीकरण प्रदान करता है जो amcharts.com पर है। इसके पीछे कोई खाते, API कुंजियाँ, उपयोगकर्ता डेटा या लेखन संचालन नहीं हैं।
  • यह Cloudflare Workers पर चलता है।
  • MCP session state एक Durable Object में रखा जाता है, जैसा कि MCP agents framework आवश्यक करता है। यह सत्र समाप्त होने पर, या इसके अंतिम अनुरोध के 24 घंटे बाद हटा दिया जाता है।
  • प्रति-अनुरोध लॉग (Workers invocation logs) बंद हैं। केवल त्रुटि संदेश लॉग किए जाते हैं, और उनमें कोई टूल आर्ग्युमेंट नहीं होता। नीचे "गोपनीयता" देखें।
• लोकल इंस्टॉल। npm पैकेज आपकी मशीन पर stdio पर चलता है और केवल उसमें बंडल की गई सामग्री पढ़ता है; यह कोई नेटवर्क अनुरोध नहीं करता। इसकी एकमात्र रनटाइम निर्भरताएँ @modelcontextprotocol/sdk और zod हैं।
• मेंटेनर स्क्रिप्ट। scripts/ में स्क्रिप्ट (डेमो और दस्तावेज़ स्क्रैपर, API संदर्भ जनरेटर) npm पैकेज का हिस्सा नहीं हैं और सर्वर में कभी नहीं चलतीं।
• किसी भेद्यता की रिपोर्ट करना: https://www.amcharts.com/report-vulnerability/

गोपनीयता

न तो होस्टेड सर्वर और न ही npm पैकेज को किसी खाते की आवश्यकता है या व्यक्तिगत डेटा माँगता है।

• होस्टेड सर्वर (https://mcp.amcharts.com/mcp):
  • आपका AI ऐप क्या भेजता है: एक खोज वाक्यांश, एक चार्ट प्रकार, एक doc पथ। इनका उपयोग केवल उत्तर बनाने के लिए किया जाता है, और इन्हें लॉग या संग्रहीत नहीं किया जाता। एक प्रतिक्रिया सत्र के स्टोरेज में केवल तब तक रखी जाती है जब तक वह वितरित न हो जाए (ताकि एक बाधित स्ट्रीम फिर से शुरू हो सके), फिर हटा दी जाती है।
  • सत्र रिकॉर्ड: जब कोई AI ऐप कनेक्ट होता है, सर्वर उसका MCP initialize संदेश सत्र के स्टोरेज में रखता है। उस संदेश में वह होता है जो ऐप अपने बारे में कहता है (उसका नाम और संस्करण, और जो कुछ और वह वहाँ रखता है), प्रोटोकॉल संस्करण और ऐप की MCP क्षमताएँ। सत्र का सारा स्टोरेज तब हटा दिया जाता है जब ऐप सत्र समाप्त करता है, या इसके अंतिम अनुरोध के 24 घंटे बाद।
  • लॉग: सर्वर कोई अनुरोध लॉग नहीं रखता (Workers invocation logs बंद हैं)। यह Cloudflare Workers पर चलता है, और Cloudflare प्रत्येक अनुरोध को, उसके IP पते सहित, वितरित करने के लिए संसाधित करता है। त्रुटि और चेतावनी संदेश लॉग किए जाते हैं और 7 दिनों तक रखे जाते हैं; उनमें कोई अनुरोध सामग्री या टूल आर्ग्युमेंट नहीं होता।
• npm पैकेज: यह आपके कंप्यूटर पर stdio पर चलता है और amCharts या किसी अन्य को कुछ नहीं भेजता।
• नीति और प्रश्न: amCharts गोपनीयता नीति देखें, या contact@amcharts.com पर लिखें।

लाइसेंस

MIT