amCharts 5 MCP Server

官方

MCP伺服器，讓AI助手能按需存取超過1,500份amCharts文件、約300個程式碼範例，以及1,000多個類別API參考資料。

你可以用 amCharts 5 MCP 做什麼？

圖表快速入門範本 — 取得任何圖表類型（例如圓餅圖或桑基圖）的最小可運作範本，以便改寫成你自己的程式碼。
文件與範例搜尋 — 依關鍵字搜尋技能文件、完整文件及 290+ 個程式碼範例，找出相關指引。
圖表類型與範例瀏覽 — 列出可用的圖表類型，或依分類篩選瀏覽範例，然後取得特定範例的完整程式碼。
API 參考查詢 — 查詢任何 amCharts 5 類別、介面或函式的設定（含預設值）、事件、繼承關係及 import 行。
地圖地理資料探索 — 尋找地圖檔案，包括世界、洲、國家、區域及美國國會選區套件，並附上 CDN 路徑與 import 詳細資訊。
框架整合指南 — 取得涵蓋 React、Vue、Angular、Svelte 及 React Native 整合的文件，包括 Next.js、Nuxt 及 SvelteKit 的設定。

文件

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 工具使用。

為什麼需要？

MCP 伺服器不會把整份 amCharts 參考資料載入 AI 的上下文視窗，而是讓 AI 只查詢它真正需要的內容——特定圖表類型的參考、程式碼範例，或 API 查詢。這表示能在減少上下文浪費的情況下獲得更好的回答。

快速開始

最簡單的方式是使用託管伺服器——無需安裝，只要加入一個 URL。想自行執行嗎？請參閱下方的本機安裝。

託管版（無需安裝）——推薦

將你的 AI 用戶端指向：

https://mcp.amcharts.com/mcp

Claude Code

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

Claude Desktop / claude.ai——設定 → 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／開發者模式的 Plus/Pro/Enterprise 版本）——設定 → Connectors → Add custom connector，然後貼上 https://mcp.amcharts.com/mcp。

Cline（VS Code 擴充功能）——開啟 MCP Servers 面板 → Remote Servers，貼上 https://mcp.amcharts.com/mcp，或加入其 MCP 設定 JSON：

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

僅支援本機（stdio）伺服器的用戶端（例如 Zed、Continue、Amazon Q Developer）——透過 mcp-remote 橋接到託管 URL。在用戶端設定中，將其作為伺服器的執行命令：

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

例如，在 command/args 風格的設定中：

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

任何其他接受遠端伺服器 URL 的 MCP 用戶端也同樣適用——請使用 /mcp 端點（Streamable HTTP）或 /sse（舊版 SSE）。對於僅接受 URL、但仍要求提供命令的用戶端，請使用上方所示的 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`	依關鍵字搜尋技能參考文件（`scope: "all"` 會加入完整文件、API 參考與範例）
`search_all`	搜尋所有內容——技能文件、完整文件與程式碼範例
`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`	尋找地圖（地理資料）檔案——世界、各大洲、國家、區域套件，以及各屆美國國會選區套件——包含每個檔案的 CDN 路徑、指令碼全域變數與 ES import

使用範例

連線後，你的 AI 助理可以：

「幫我建立一個圓餅圖」 → AI 呼叫 get_quick_start("pie") 並調整範本
「我要如何格式化日期軸標籤？」 → AI 呼叫 search_all("date axis label format")
「給我看 Sankey 圖範例」 → 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()
「繪製目前的美國國會選區地圖」 → AI 呼叫 list_geodata("congressional whole country")

內容

此伺服器包含 1,800+ 份文件：

160+ 個文件頁面——入門指南、圖表指南、概念（主題、事件、配接器、資料繫結、動畫、無障礙等），以及 amCharts 的 React、Vue、Angular、Svelte 與 React Native 套件的框架整合指南（含 Next.js、Nuxt、SvelteKit、React Router 與 Remix 3）
290+ 個程式碼範例——涵蓋 16 個類別的可用示範，包括柱狀／長條、折線／區域、圓餅／環圈、地圖、階層、流程、雷達／極座標、股票、儀表、甘特圖、時間軸等
1,300+ 個 API 參考頁面——amCharts 5 函式庫中的每個類別、介面與函式，皆由該版本的型別定義產生：包含設定及其實際預設值（含主題規則）、事件、屬性、資料項目欄位、繼承鏈與 import 行
670+ 個地理資料項目——@amcharts/amcharts5-geodata 中的每一張地圖，供 list_geodata 使用
精選技能參考——來自 amCharts 5 AI Skill 的快速入門範本與各圖表專屬指南

安全性

唯讀工具。 每個工具都只讀取隨附的 amCharts 文件並回傳文字。沒有任何工具會寫入檔案、執行命令或擷取 URL。
託管端點依設計不具身分驗證。 https://mcp.amcharts.com/mcp 提供的內容與 amcharts.com 相同的公開文件。其背後沒有帳號、API 金鑰、使用者資料或寫入操作。
- 它執行於 Cloudflare Workers。
- MCP 工作階段狀態儲存於 Durable Object 中，這是 MCP agents 框架的要求。工作階段結束時，或在其最後一次請求後 24 小時，該狀態會被刪除。
- 已關閉逐請求日誌（Workers 呼叫日誌）。僅記錄錯誤訊息，且其中不含任何工具引數。請參閱下方的「隱私權」。
本機安裝。 npm 套件在你的機器上透過 stdio 執行，且只讀取隨附於其中的內容；它不會發出任何網路請求。其唯一的執行階段相依套件為 @modelcontextprotocol/sdk 與 zod。
維護者指令碼。 scripts/ 中的指令碼（示範與文件擷取器、API 參考產生器）不屬於 npm 套件，也絕不會在伺服器中執行。
回報漏洞： https://www.amcharts.com/report-vulnerability/

隱私權

託管伺服器與 npm 套件皆不需要帳號，也不會要求個人資料。

託管伺服器（https://mcp.amcharts.com/mcp）：
- 你的 AI 應用程式傳送的內容： 搜尋詞、圖表類型、文件路徑。這些僅用於建構回答，不會被記錄或儲存。回應僅保留於工作階段的儲存空間，直到送達為止（以便中斷的串流能續傳），之後即刪除。
- 工作階段記錄： 當 AI 應用程式連線時，伺服器會將其 MCP 初始化訊息保留於工作階段的儲存空間。該訊息包含應用程式對自身的描述（其名稱與版本，以及它放入的任何其他內容）、通訊協定版本與應用程式的 MCP 能力。當應用程式結束工作階段時，或在其最後一次請求後 24 小時，該工作階段的全部儲存空間會被刪除。
- 日誌： 伺服器不保留請求日誌（Workers 呼叫日誌已關閉）。它執行於 Cloudflare Workers，Cloudflare 會處理每個請求（包括其 IP 位址）以完成傳遞。錯誤與警告訊息會被記錄並保留最多 7 天；其中不含任何請求內容或工具引數。
npm 套件： 它透過 stdio 在你的電腦上執行，不會傳送任何內容給 amCharts 或任何其他人。
政策與問題： 請參閱 amCharts 隱私權政策，或來信 contact@amcharts.com。

授權條款

MIT