MCP ECharts

社区

使用 ECharts 动态生成可视化图表，用于图表生成和数据分析。

分类: 其他第 38 / 230
Stars: ★ 270 热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Node.js 18+
凭据: 无需凭据
许可证: MIT
最近提交: 56 天前
工具数: 2

65FMRS · C

MCP ECharts 是一个功能强大的 MCP 服务器，基于 Apache ECharts 生成图表，支持多种输出格式和存储选项。它易于安装，零依赖，且完全本地化，适合数据分析和 AI 驱动的图表生成。但性能受限于本地资源，且需要 Node.js 环境。

最强项 · 维护活跃度 17/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

17/20

文档质量

15/20

安装易用性

15/20

查看各项评分依据

可靠性 8/20: 静态审查显示项目有CI工作流（build.yml）和测试文件（如test/目录），但未实际运行，无法确认服务器能够干净启动并完成MCP握手。README中声称支持多种传输方式（stdio、SSE、streamable）和多种输出格式，但缺少对工具参数的详细测试证据。因此可靠性得分上限为8，主要依据是存在CI和测试文件，但未验证实际行为。
安全与权限 10/20: 服务器完全本地生成图表，不依赖远程服务（除可选的MinIO），降低了外部网络风险。MinIO配置通过环境变量管理，未发现硬编码凭证。但缺乏对输出内容的安全过滤（如防止恶意SVG/PNG注入）和权限最小化的显式声明。MinIO集成可能引入额外攻击面，但默认未启用。未触发红线风险，因此得分10。
维护活跃度 17/20: 仓库非归档，有4个开放issue，最近有提交（基于README的贡献者信息）。项目使用MIT许可证，有持续开发迹象（多个贡献者修复问题）。但未看到明确的版本发布策略和依赖更新政策，因此得分为17，略低于满分。
文档质量 15/20: README提供了详细的安装和使用说明，包括桌面应用配置示例、CLI选项、MinIO配置步骤以及开发指南。文档结构清晰，覆盖了主要使用场景，但缺少对工具参数的详细参考、错误排查指南和成本说明（如MinIO存储费用）。因此得分为15。
安装易用性 15/20: 安装步骤简单：通过npx运行或全局安装npm包，并提供桌面应用配置示例。支持Windows和Mac。但需要在客户端（如Claude）中手动配置MCP服务器JSON，且未提供Node.js版本的具体检查。静态审查未包含可验证的安装测试，因此得分上限为15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要快速生成图表的数据分析师、开发者和 AI 应用开发者。
希望集成图表生成到 LLM 工作流的用户。
需要图表导出为多种格式的用户。

不适合谁

需要复杂交互式图表或实时数据更新的用户。
需要大量图表存储和管理的企业级用户（可能需额外配置 MinIO）。
希望图表完全托管的用户（本地生成，不依赖云服务）。

所需权限

能够访问文件系统以读取配置和输出文件。
当配置 MinIO 时，需要访问 MinIO 服务的权限。
需要网络访问以安装 npm 包（如果是通过 npx 运行）。

风险与副作用

由于生成完全在本地执行，性能可能受限于本地资源。
如果未配置 MinIO，导出的图表将以 Base64 形式返回，可能较大，影响响应速度。
依赖 Node.js 环境，需确保版本兼容。

安装接入

准备工作

运行环境：Node.js 18+

MINIO_ACCESS_KEY 可选密钥对象存储访问密钥，在 MinIO/S3 等存储服务的控制台获取，可选配置。

MINIO_SECRET_KEY 可选密钥对象存储访问密钥对应的私钥，与 access key 配对，在存储服务控制台获取，可选配置。

其他可选配置项（4 个）

MINIO_ENDPOINT 可选 MinIO 或 S3 兼容对象存储的服务地址，如 localhost，可选配置。

MINIO_PORT 可选对象存储服务端口，默认示例为 9000，可选配置。

MINIO_USE_SSL 可选是否启用 SSL 连接，true/false，可选配置。

MINIO_BUCKET_NAME 可选用于存放图表图片的存储桶名称，可选配置，需在存储服务中预先创建。

确保 Node.js 18 或更高版本。
在客户端的 MCP 配置文件中添加以下配置：

{
  "mcpServers": {
    "mcp-echarts": {
      "command": "npx",
      "args": ["-y", "mcp-echarts"]
    }
  }
}

对于 Windows 系统，请使用 cmd /c npx -y mcp-echarts。

如果需要 SSE 或流式传输，可以全局安装：npm install -g mcp-echarts，然后运行 mcp-echarts -t sse 或 mcp-echarts -t streamable。

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-echarts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-echarts"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "mcp-echarts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-echarts"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mcp-echarts -- npx -y mcp-echarts

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中确认出现 echarts_generate_chart 和 validate_chart_option 两个工具，然后让 AI 生成一张简单图表并确认返回 png/svg 或 Base64 数据即说明连接成功。

常见排障

常见问题： - 确保 Node.js 版本 >= 18。 - 如果无法运行 `npx`，请检查 npm 是否安装正确。 - 对于 SSE 或流式传输，检查端口是否被占用，默认端口为 3033。 - 如果配置了 MinIO，检查环境变量是否正确设置，否则会自动回退到 Base64。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 ECharts 生成一个 2024 年每月销量的柱状图并导出为 png
把这份季度数据画成折线图，使用暗色主题
帮我校验这个 ECharts option 配置是否合法，再渲染成 svg
生成一个饼图展示各类别占比，并输出 option 格式方便我二次修改

工具能力 2

echarts_generate_chart 写入

根据提供的选项生成 ECharts 图表，并输出为 PNG、SVG 或 option 格式。

validate_chart_option 只读

校验 ECharts 配置对象的有效性，确保语法正确。

使用场景

通过自然语言生成可视化图表，无需手动编写代码。

在数据分析工作流中快速创建图表，辅助决策。

生成可分享的图表链接，便于协作。

支持客户端

Claude Desktop

VS Code部分支持

Cline部分支持

Cherry Studio部分支持

依据项目文档列出，未经本站实测。

详细介绍

这是一个 MCP 服务器，利用 AI 动态生成 Apache ECharts 图表。它支持 ECharts 的全部功能和语法，包括数据、样式、主题等。可以导出为 PNG、SVG 和 option 格式，并提供 ECharts 校验，以帮助模型多轮输出正确的语法和图形。集成 MinIO 对象存储，可将图表存储为 URL 而不是 Base64，提高性能和分享能力。轻量级，零依赖，完全本地生成，不依赖远程服务。