STARWARCLOUD STARWAR.AI
返回市场
麦普图表服务

麦普图表服务

作者：hustcc159 星标更新：2025-10-20
安装使用来源：spider==github.com

项目介绍

<img src="https://gips1.baidu.com/it/u=533981415,2354718094&fm=3081&app=3081&f=PNG?w=147&h=147" height="24"/> MCP ECharts build npm Version smithery badge npm License Trust Score

生成 <img src="https://gips1.baidu.com/it/u=533981415,2354718094&fm=3081&app=3081&f=PNG?w=147&h=147" height="14"/> Apache ECharts 使用AI MCP动态生成图表和数据分析。也可以使用 <img src="https://mdn.alipayobjects.com/huamei_qa8qxu/afts/img/A*ZFK8SrovcqgAAAAAAAAAAAAAemJ7AQ/original" height="14"/> mcp-server-chart 来生成图表、图形和地图。

<div align="center"> <img width="648" alt="mcp-echarts" src="https://gips1.baidu.com/it/u=2352599084,2605485066&fm=3081&app=3081&f=JPEG?w=2256&h=774" /> </div> <div align="center"> <img width="648" alt="award" src="https://gips0.baidu.com/it/u=3149220342,53248753&fm=3081&app=3081&f=PNG?w=1854&h=1312" /> </div>

✨ 特性

  • 完全支持所有 ECharts 的特性和语法，包括数据、样式、主题等。
  • 支持导出到 png、svg 和 option 格式，并对 ECharts 进行验证，以方便模型多次输出正确的语法和图形。
  • 集成 MinIO，将图表存储在 MinIO 对象存储中并返回 URL 而不是 Base64 数据，以提高性能和共享能力。
  • 轻量级，可以轻松安装，无需任何依赖。
  • 极其安全，完全本地生成，不依赖任何远程服务。

🤖 使用方法

桌面应用程序（stdio 传输）

要在 桌面应用 中使用，如 Claude、VSCode、Cline、Cherry Studio 等，请添加以下 MCP 服务器配置。在 Mac 系统上：

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

在 Windows 系统上：

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

您还可以在 modelscope，glama.ai，smithery.ai 或其他支持 HTTP、SSE 协议的地方使用它。

🚰 使用 SSE 或可流传输传输运行

全局安装包。

npm install -g mcp-echarts

使用您首选的传输选项运行服务器：

# 对于 SSE 传输（默认端点：/sse）
mcp-echarts -t sse

# 对于可流传输传输，自定义端点
mcp-echarts -t streamable

然后您可以访问以下地址的服务器：

  • SSE 传输：http://localhost:3033/sse
  • 可流传输传输：http://localhost:3033/mcp

🎮 CLI 选项

运行 MCP 服务器时，您还可以使用以下 CLI 选项。通过运行带有 -h 参数的 CLI 查看命令选项。

MCP ECharts CLI

选项：
  --transport, -t  指定传输协议："stdio"、"sse" 或 "streamable"（默认："stdio"）
  --port, -p       指定 SSE 或可流传输的端口（默认：3033）
  --endpoint, -e   指定传输的端点：
                    - 对于 SSE：默认是 "/sse"
                    - 对于可流传输：默认是 "/mcp"
  --help, -h       显示此帮助信息

🗂️ MinIO 配置（可选）

为了更好的性能和共享能力，您可以配置 MinIO 对象存储来存储图表图像作为 URL 而不是 Base64 数据。

[!NOTE] 如果未配置或无法使用 MinIO，系统会自动回退到 Base64 数据输出，确保兼容性。

我们可以与以下 MinIO 对象存储提供商集成。

我们还可以免费设置本地 MinIO。

  1. 安装并启动本地 MinIO：

    # 下载 MinIO（macOS 示例）
brew install minio/stable/minio

# 启动 MinIO 服务器
minio server ~/minio-data --console-address :9001

  2. 配置环境变量：

    # 复制示例环境文件
cp .env.example .env

# 编辑 .env 文件，填写您的 MinIO 设置
MINIO_ENDPOINT=localhost
MINIO_PORT=9000
MINIO_USE_SSL=false
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET_NAME=mcp-echarts

🔨 开发

安装依赖项：

npm install

构建服务器：

npm run build

启动 MCP 服务器：

npm run start

🧑🏻‍💻 贡献者

  • lyw405：支持 15+ 图表 MCP 工具。#2
  • 2niuhe：支持 MCP 的 SSE 和流式 HTTP。#17
  • susuperli：使用 MinIO 保存图表图像的 Base64 并返回 URL。#10
  • BQXBQX：使用 @napi-rs/canvas 替代 node-canvas。#3
  • Meet-student：为所有图表工具添加 outputType 模式。#24
  • hustcc：初始化仓库。

📄 许可证

MIT@hustcc。