# @amcharts/amcharts5-mcp 中文文档

规范地址：https://npmcn.com/package/%40amcharts/amcharts5-mcp/

版本：1\.9\.4
npm 元数据更新时间：2026-10-25T19:28:19.630Z
中文译文更新时间：2026-11-06T07:45:56.111Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40amcharts/amcharts5-mcp
原文对照：https://npmcn.com/package/%40amcharts/amcharts5-mcp/?lang=original
项目主页：https://github.com/amcharts/amcharts5-mcp#readme
源码仓库：https://github.com/amcharts/amcharts5-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：7.9 MB，1945 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2026-03-15T10:47:50.865Z
- 最新版本发布：2026-10-25T19:28:19.461Z
- 近 30 天下载量：4111（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

按需访问 amcharts 5 Docs, 代码示例和 API 引用

## 安装

```sh
npm install @amcharts/amcharts5-mcp
```

也可以使用：`pnpm add @amcharts/amcharts5-mcp`、`yarn add @amcharts/amcharts5-mcp`、`bun add @amcharts/amcharts5-mcp`

## README

# 图表 5 MCP 服务器

一个 [MCP(示范背景议定书)](https://modelcontextprotocol.io/) 服务器,允许 AI 助手按需访问完整的 amcharts 5 知识库: **160+ 文件页**, (中文(简体) ), **350+ 代码示例** (包括60+完整的JSON配置),和 **1 300+ API 参考页**。 。 。 .

与 **克劳德代码**, (中文(简体) ), **克劳德桌面**, (中文(简体) ), **光标**, (中文(简体) ), **风起浪起**, (中文(简体) ), **VS 代码 + GitHub 副驾驶**,以及任何其他MCP相容的AI工具.

## 为什么?

MCP 服务器让 AI 输入 AI 的上下文窗口,而不是将全部 amCharts 引用 **查询它需要什么** ——特定的图表类型参考,代码示例,或API查询. 这意味着用较少的背景浪费来更好的回答.

## 快速启动

最简单的方式是 **主机服务器** ——没有安装,只需添加一个URL. 喜欢 你自己开? 见 [本地安装](https://npmcn.com/package/%40amcharts/amcharts5-mcp/#readme-local-install-npx) 见下文.

### 主机(没有安装)——建议

对准你的AI客户端:

```
https://mcp.amcharts.com/mcp
```

图表 5 文档也在 [A. 背 景7](https://context7.com/amcharts/amcharts5) 作为 `/amcharts/amcharts5`。 。 。 .

**克劳德代码**

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

**克劳德( Claude.ai, 桌面)** - 增加图5 [连接目录](https://claude.ai/directory/amcharts)或设置 / 连接器 / **添加自定义连接器**,然后粘贴 `https://mcp.amcharts.com/mcp`。 。 。 .

**光标** —— 说 `.cursor/mcp.json`数字 :

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

**VS 代码 + GitHub 副驾驶** —— 说 `.vscode/mcp.json`数字 :

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

**风起浪起** —— 说 `~/.codeium/windsurf/mcp_config.json`数字 :

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

**聊天游戏** (同样在自由计划中)——开放 [插件](https://chatgpt.com/plugins) → **\+ 键** → **添加自定义 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 :

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

**仅支持本地( stdio) 服务器的客户端** (例如:Zed, Continent, Amazon Q开发者)——连接到主机URL的桥接方式有: [`mcp-remote`](https://www.npmjs.com/package/mcp-remote)。将此作为服务器在客户端配置中的运行命令:

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

例如,在一个 `command`编号 :`args` 样式配置 :

```json
{
  "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上.

### 克劳德代码

对于 **所有项目** (全球,建议):

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

对于 **仅当前项目**数字 :

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

### 克劳德桌面

添加到您的 `claude_desktop_config.json`数字 :

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

### 光标

创建或编辑 `.cursor/mcp.json` 在项目根中(或 `~/.cursor/mcp.json` (单位:千美元)

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

### 风起浪起

编辑 `~/.codeium/windsurf/mcp_config.json`数字 :

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

### VS 代码 + GitHub 副驾驶

创建或编辑 `.vscode/mcp.json` 在工作空间中 :

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

### 其他与MCP兼容的工具

对于支持MCP的其他任何工具(Cline, Clue, Amazon Q, Zed等),配置其运行:

```bash
npx -y @amcharts/amcharts5-mcp
```

### 本地运行( 为开发)

```bash
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 技能](https://github.com/amcharts/amcharts5-skill)

## 警卫

-   **唯读工具.** 每个工具都读取捆绑的安图文档并返回文本. 没有工具写入文件, 运行命令或获取 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/ (中文(简体) )](https://www.amcharts.com/report-vulnerability/)

## 隐私

主机服务器和npm软件包都不需要账户或询问个人数据.

-   **主机服务器** (单位:千美元)`https://mcp.amcharts.com/mcp`:
    -   **你的AI应用程序发送的信息:** 搜索短语、图表类型、文件路径。 这些只用于构建答案,而不记录或存储. 响应只保存在会话的存储中,直到发送完毕(这样可以恢复掉落的流),然后被删除.
    -   **会议记录:** 当一个AI应用程序连接时,服务器会在会话存储中保留其MCP初始化消息. 该消息保留了应用程序对自己(它的名称和版本,以及它所显示的其他内容),协议版本和应用程序的MCP能力. 当应用程序结束会话时, 或在其最后一次请求后24小时, 会话的所有存储都会被删除 .
    -   **日志 :** 服务器不保存请求日志(工人引用日志已关闭)。 它运行在Cloudflare Workers上,Cloudflare处理每个请求,包括其IP地址,以交付. 错误和警告信息被记录并保存了长达7天;它们没有请求内容或工具参数.
-   **npm 软件包 :** 它运行在你的电脑上过 Stdio, 并且发送什么 给阿姆哈特或其他任何人.
-   **政策和问题:** 见 [图表隐私政策](https://www.amcharts.com/privacy-policy/),或写入 [联系人@amcharts.com](mailto:contact@amcharts.com)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @amcharts/amcharts5-mcp 是什么？

按需访问 amcharts 5 Docs, 代码示例和 API 引用

### 如何安装 @amcharts/amcharts5-mcp？

在项目目录运行 npm install @amcharts/amcharts5-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 amcharts5-mcp，可以用 npx amcharts5-mcp 直接运行。

### @amcharts/amcharts5-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/amcharts\_\_amcharts5-mcp 是否存在。

### @amcharts/amcharts5-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @amcharts/amcharts5-mcp 可以商用吗？

@amcharts/amcharts5-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @amcharts/amcharts5-mcp 的下载量有多少？

根据 npm 官方下载统计，@amcharts/amcharts5-mcp 在 2026/10/06 – 2026/11/04 这 30 天内被下载 4,111 次，日均约 137 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @amcharts/amcharts5-mcp 还在维护吗？

最新版本 1\.9\.4 发布于 2026/10/26（13 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/03/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。