amCharts 5 MCP Server

官方

MCP服务器，让AI助手按需访问1500多份amCharts文档、约300个代码示例以及1000多个类API参考。

GitHub

你可以用 amCharts 5 MCP 做什么？

图表快速入门模板 — 获取任意图表类型（如饼图或桑基图）的最小可运行模板，以便改编为自己的代码。
文档与示例搜索 — 按关键词搜索技能文档、完整文档和 290+ 代码示例，找到相关指导。
图表类型与示例浏览 — 列出可用的图表类型，或按类别筛选浏览示例，然后获取特定示例的完整代码。
API 参考查询 — 查询任意 amCharts 5 类、接口或函数的设置及其默认值、事件、继承关系和导入语句。
地图地理数据查找 — 查找地图文件，包括世界、大洲、国家、区域和美国国会选区包，含 CDN 路径和导入详情。
框架集成指南 — 获取涵盖 React、Vue、Angular、Svelte 和 React Native 集成的文档，包括 Next.js、Nuxt 和 SvelteKit 配置。

文档

amCharts 5 MCP Server

一个 MCP（模型上下文协议）服务器，让 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——设置 → 连接器 → 添加自定义连接器，然后粘贴 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（Plus/Pro/Enterprise，需启用连接器/开发者模式）——设置 → 连接器 → 添加自定义连接器，然后粘贴 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 参考——包含默认值的设置、事件、继承关系以及导入语句
`list_geodata`	查找地图（地理数据）文件——世界、大洲、国家、区域包以及按届国会划分的美国国会选区包——包含每个文件的 CDN 路径、脚本全局变量和 ES 导入

使用示例

连接后，你的 AI 助手可以：

"帮我构建一个饼图" → AI 调用 get_quick_start("pie") 并调整模板
"如何格式化日期轴标签？" → AI 调用 search_all("date axis label format")
"给我看看桑基图示例" → 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 库中的每个类、接口和函数，根据该版本的类型定义生成：包含真实默认值的设置（含主题规则）、事件、属性、数据项字段、继承链以及导入语句
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