mcp-server-chart

环境要求

• 已安装 Node.js（提供 npx、npm 命令）
• 一款支持 MCP 的客户端，如 Claude、VSCode、Cline、Cherry Studio、Cursor
• 可选：私有化部署时需自建 GPT-Vis-SSR 等图表渲染 HTTP 服务
• 可选：使用 Docker 部署时需安装 Docker 与 docker compose

安装与启动步骤

1. 1Mac 端配置 MCP

   在支持 MCP 的桌面客户端（Claude、VSCode、Cursor 等）的 MCP 配置中加入以下服务器，客户端会自动用 npx 拉取运行。

   {
     "mcpServers": {
       "mcp-server-chart": {
         "command": "npx",
         "args": ["-y", "@antv/mcp-server-chart"]
       }
     }
   }

   复制

2. 2Windows 端配置 MCP

   Windows 上要先经 cmd 再调用 npx，因此 command 填 cmd，args 前加 /c。配置结构与 Mac 相同。

   {
     "mcpServers": {
       "mcp-server-chart": {
         "command": "cmd",
         "args": ["/c", "npx", "-y", "@antv/mcp-server-chart"]
       }
     }
   }

   复制

3. 3全局安装服务包

   若不想每次由 npx 拉取，可全局安装该包，再用自己需要的 SSE 或 Streamable transport 方式启动服务。

   npm install -g @antv/mcp-server-chart

   复制

4. 4Docker 方式部署

   进入仓库的 docker 目录后用 docker compose 后台启动，适合自托管服务端并以 HTTP/SSE 协议接入。

   cd docker
   docker compose up -d

   复制

5. 5安装可视化技能

   在支持 skill 的 AI IDE（如 Claude Code）中通过 npx skills 安装 chart-visualization 技能，由它自动挑选图表类型。

   npx skills add antvis/chart-visualization-skills

   复制

6. 6接入私有渲染服务

   在 MCP 配置的 env 中把 VIS_REQUEST_SERVER 指向自己部署的图表渲染 HTTP 服务地址。

   {
     "mcpServers": {
       "mcp-server-chart": {
         "command": "npx",
         "args": ["-y", "@antv/mcp-server-chart"],
         "env": {
           "VIS_REQUEST_SERVER": "https://your-chart-server.example.com/api"
         }
       }
     }
   }

   复制

关键配置

如何确认成功

Docker 部署后访问 http://localhost:1123/sse 或 http://localhost:1122/mcp 有响应；客户端连上后能看到 generate_* 系列图表工具。

常见问题

注意事项

• 默认使用官方免费图表生成服务，需要私有化时用 VIS_REQUEST_SERVER 指向自建服务。
• README 节选中 Run directly 的 transport 启动命令未完整展示，请以仓库原文为准，不要自行猜测参数。
• Docker 部署必须先进入仓库的 docker 目录再执行 docker compose up -d，否则找不到 compose 文件。
• 私有化部署目前不支持 3 个地理可视化图表工具。