amCharts 5 MCP 服务器

Name: amCharts 5 MCP Server
Author: amcharts

一个 MCP (Model Context Protocol) 服务器，为 AI 助手提供按需访问完整的 amCharts 5 知识库的能力：140 多篇文档页面、280 多份代码示例以及 1000 多份类 API 参考。

适用于 Claude Code、Claude Desktop、Cursor、Windsurf、VS Code + GitHub Copilot 以及任何其他兼容 MCP 的 AI 工具。

为什么使用它？

与其将整个 amCharts 参考资料加载到 AI 的上下文窗口中，不如让 AI 按需查询所需内容——特定的图表类型参考、代码示例或 API 查询。这意味着在减少上下文浪费的同时获得更好的回答。

快速开始

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`	按关键字搜索技能参考文档
`search_all`	搜索所有内容 — 技能文档、完整文档和代码示例
`get_doc`	获取完整的文档页面（例如 "charts/xy-chart/axes"、"concepts/events"）
`get_section`	通过标题从参考文件中获取特定部分
`get_quick_start`	获取任何图表类型的最小工作模板
`list_examples`	浏览所有 283 个示例，可按类别筛选
`get_example`	获取特定示例的完整代码

使用示例

连接后，你的 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")
“有哪些可用的图表类型？” → AI 调用 list_chart_types()

内容

该服务器包含 1500 多份文档：

140 多篇文档页面 — 入门指南、图表指南、概念（主题、事件、适配器、数据绑定、动画、可访问性等）以及框架集成指南（React、Angular、Vue、Next.js、Svelte 等）
280 多份代码示例 — 涵盖 16 个类别的演示，包括柱状图/条形图、折线图/面积图、饼图/环形图、地图、层级图、流向图、雷达图/极坐标图、股票图、仪表盘、甘特图、时间轴等
1000 多份类 API 参考 — amCharts 5 库中的每个类及其设置、属性、方法、事件和继承链
精选技能参考 — 来自 amCharts 5 AI Skill 的快速入门模板和特定图表指南

许可证

MIT

amCharts 5 MCP Server