图表 5 MCP 服务器
一个 MCP(示范背景议定书) 服务器,允许 AI 助手按需访问完整的 amcharts 5 知识库: 160+ 文件页, (中文(简体) ), 350+ 代码示例 (包括60+完整的JSON配置),和 1 300+ API 参考页。 。 。 .
与 克劳德代码, (中文(简体) ), 克劳德桌面, (中文(简体) ), 光标, (中文(简体) ), 风起浪起, (中文(简体) ), VS 代码 + GitHub 副驾驶,以及任何其他MCP相容的AI工具.
为什么?
MCP 服务器让 AI 输入 AI 的上下文窗口,而不是将全部 amCharts 引用 查询它需要什么 ——特定的图表类型参考,代码示例,或API查询. 这意味着用较少的背景浪费来更好的回答.
快速启动
最简单的方式是 主机服务器 ——没有安装,只需添加一个URL. 喜欢 你自己开? 见 本地安装 见下文.
主机(没有安装)——建议
对准你的AI客户端:
https://mcp.amcharts.com/mcp
图表 5 文档也在 A. 背 景7 作为 /amcharts/amcharts5。 。 。 .
克劳德代码
claude mcp add --transport http amcharts5 https://mcp.amcharts.com/mcp
克劳德( Claude.ai, 桌面) - 增加图5 连接目录或设置 / 连接器 / 添加自定义连接器,然后粘贴 https://mcp.amcharts.com/mcp。 。 。 .
光标 —— 说 .cursor/mcp.json数字 :
{
"mcpServers": {
"amcharts5": {
"url": "https://mcp.amcharts.com/mcp"
}
}
}
VS 代码 + GitHub 副驾驶 —— 说 .vscode/mcp.json数字 :
{
"servers": {
"amcharts5": {
"type": "http",
"url": "https://mcp.amcharts.com/mcp"
}
}
}
风起浪起 —— 说 ~/.codeium/windsurf/mcp_config.json数字 :
{
"mcpServers": {
"amcharts5": {
"serverUrl": "https://mcp.amcharts.com/mcp"
}
}
}
聊天游戏 (同样在自由计划中)——开放 插件 → + 键 → 添加自定义 MCP 服务器。给出名称,设置 URL 到 https://mcp.amcharts.com/mcp 认证到 没有认证,则 作为插件创建在聊天中,类型 @am图 用来使用它.
图像制作和图像代理 (支付法格玛计划)——在聊天中,打开 添加上下文 → 连接器 → 管理 → 创建名称 amCharts,将 URL 设置为 https://mcp.amcharts.com/mcp 没有认证,并设置工具到 总是运行。然后在提示中命名 am Charts (Make picks Recharts otherse),例如"建造有am Charts的销售仪表板:以收入为颜色的世界地图和每月销售的行图". 制造安装 @amcharts/amcharts5 然后通过服务器查看代码 。 粘贴的 amcharts.com 演示或 docs 链接也作为上下文工作 .
线 (VS代码扩展)——打开 MCP 服务器 专门小组 + 远程服务器粘贴 https://mcp.amcharts.com/mcp,或者在其 MCP 设置中添加 JSON :
{
"mcpServers": {
"amcharts5": {
"type": "streamableHttp",
"url": "https://mcp.amcharts.com/mcp"
}
}
}
仅支持本地( stdio) 服务器的客户端 (例如:Zed, Continent, Amazon Q开发者)——连接到主机URL的桥接方式有: mcp-remote。将此作为服务器在客户端配置中的运行命令:
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 mcp add -s user amcharts5 -- npx -y @amcharts/amcharts5-mcp
对于 仅当前项目数字 :
claude mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcp
克劳德桌面
添加到您的 claude_desktop_config.json数字 :
{
"mcpServers": {
"amcharts5": {
"command": "npx",
"args": ["-y", "@amcharts/amcharts5-mcp"]
}
}
}
光标
创建或编辑 .cursor/mcp.json 在项目根中(或 ~/.cursor/mcp.json (单位:千美元)
{
"mcpServers": {
"amcharts5": {
"command": "npx",
"args": ["-y", "@amcharts/amcharts5-mcp"]
}
}
}
风起浪起
编辑 ~/.codeium/windsurf/mcp_config.json数字 :
{
"mcpServers": {
"amcharts5": {
"command": "npx",
"args": ["-y", "@amcharts/amcharts5-mcp"]
}
}
}
VS 代码 + GitHub 副驾驶
创建或编辑 .vscode/mcp.json 在工作空间中 :
{
"servers": {
"amcharts5": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@amcharts/amcharts5-mcp"]
}
}
}
其他与MCP兼容的工具
对于支持MCP的其他任何工具(Cline, Clue, 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 | 获得核心图5 Docs——设置,主题,颜色,事件,常见的陷阱. 概述:其前几节,最多可有12,000个字符,并列出其他字符; full: true 用于整个文件 |
get_chart_reference | 获取图表类型(如"pie","sankey","xy")的引用. 一个超过12 000个字符作为概览,其余列出 get_section· ; full: true 用于整个文件 |
list_chart_types | 列出所有可用的图表类型及其关键词 |
search_docs | 以关键词搜索技能参考文件( T)scope: "all" 添加完整的文件、 API 参考和示例) |
search_all | 搜索过 所有的东西 技能文件、完整文件和代码示例 |
get_doc | 按路径获取完整的文档页面(如"图表/xy-chart/xes","概念/事件")或其docs.amcharts.com地址 |
get_section | 按标题从参考文件中获取一个特定区域(a) ### 小节标题只返回该小节) |
get_quick_start | 获取任何图表类型的最小工作模板 |
list_examples | 浏览所有 350 + 例, 可选择按类别过滤 |
get_example | 以路径或 amcharts.com 演示地址获取特定示例的完整代码 |
get_api_reference | 获取类、 界面或函数的 API 引用—— 设置它们的默认值、 事件、 继承和导入行 |
list_geodata | 查找地图(地理数据)文件——世界,大陆,国家,区域包和每届国会的美国国会区包——每个文件的CDN路径,脚本全球和ES导入 |
示例使用
一旦连接,你的AI助手可以:
- "给我准备一张馅饼" - 大赦国际打电话
get_quick_start("pie")并调整模板 - "我如何格式化日期轴标签" - 大赦国际打电话
search_all("date axis label format") - "给我看看桑克图" - 大赦国际打电话
get_example("examples/flow/sankey-diagram") - "XYChart支持什么设置?" - 大赦国际打电话
get_doc("reference/xychart") - "我怎么和React融合起来?" - 大赦国际打电话
get_doc("getting-started/integrations/react"),涵盖@amcharts/amcharts5-react软件包 - "有哪些图表类型" - 大赦国际打电话
list_chart_types() - "放大目前的美国国会选区" - 大赦国际打电话
list_geodata("congressional whole country") - 粘贴的 amcharts.com 链接例如,“使一个像https://www.amcharts.com/demos/sankey-diagram/” —— 不论AI使用何种工具(搜索,
get_doc, (中文(简体) ),get_example)指向返回演示代码或docs页面或区域
内容
服务器包含 1 900多份文件数字 :
- 160+ 文件页 启动、图表指南、概念(主题、事件、适配器、数据绑定、动画、可访问性等),以及Amcharts' React、Vue、Angular、Svelte和React Environment 软件包的框架整合指南(包括Next.js、Nuxt、SvelteKit、React Router和Remix 3)
- 350+ 代码示例 290+ 工作演示分为16个类别,包括栏/栏、行/区、馅饼/杜努特、地图、等级、流动、雷达/极地、库存、测量、甘特、时间表等,另外还有60+ 完整的JSON配置图 npm包
- 1 300+ API 参考页 ——从发行的打字生成的amCharts 5 库中的每一类,接口和函数:包含其真实默认的设置(包括主题规则),事件,属性,数据项字段,继承链和导入行
- 670+ 地理数据条目 - 每张地图
@amcharts/amcharts5-geodata,用于list_geodata - 通用技能参考 快速启动模板、图表专用指南和编写 JSON 配置的指南 图表5 AI 技能
警卫
- 唯读工具. 每个工具都读取捆绑的安图文档并返回文本. 没有工具写入文件, 运行命令或获取 URL .
- 按设计,主机端点没有认证.
https://mcp.amcharts.com/mcp提供与amcharts.com相同的公开文件。 后面没有账户,API密钥,用户数据或写入操作.- 它运行在Cloudflare工人.
- MCP会话状态按照MCP代理框架的要求保存在一个持久对象中. 当届会结束时,或在其最后一次请求后24小时,将删除.
- 要求日志(工人引用日志)已关闭。 只有错误消息会被记录,它们没有工具参数 。 见下文"隐私".
- 本地安装. 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小时, 会话的所有存储都会被删除 .
- 日志 : 服务器不保存请求日志(工人引用日志已关闭)。 它运行在Cloudflare Workers上,Cloudflare处理每个请求,包括其IP地址,以交付. 错误和警告信息被记录并保存了长达7天;它们没有请求内容或工具参数.
- npm 软件包 : 它运行在你的电脑上过 Stdio, 并且发送什么 给阿姆哈特或其他任何人.
- 政策和问题: 见 图表隐私政策,或写入 联系人@amcharts.com。 。 。 .
许可证
麻省理工学院