Quick Chart MCP

🚀 快速图表 MCP 服务器

一个实现模型上下文协议 (MCP) 的服务器，提供图表工具，让其能够通过标准化接口与 快速图表 进行交互。基于图表定义，该服务器可使用户无缝打开快速图表页面。

🚀 快速开始

此 MCP 服务器工具主要用于与 Quick Chart 进行交互，并且实现了模型上下文协议规范，以此来标准化 AI 代理的图表交互。

📦 安装指南

先决条件

• Node.js (v16 或更高版本)
• pnpm（推荐）、npm 或 yarn

安装方式

通过 Smithery 安装

若要为 Claude Desktop 自动安装 quick-chart-mcp，可使用 Smithery：

npx -y @smithery/cli install @datafe/quick-chart-mcp --client claude

选项 1：通过 npm 安装（推荐用于 Cursor/Cline 等客户端）

# 全局安装
npm install -g quick-chart-mcp

# 或者在项目中本地安装
npm install quick-chart-mcp

选项 2：从源码构建（供开发者使用）

1. 克隆此仓库：

git clone https://github.com/datafe/quick-chart-mcp
cd quick-chart-mcp

2. 安装依赖项（推荐使用 pnpm，支持 npm）：

pnpm install

3. 构建项目：

pnpm run build

4. 开发项目（由 @modelcontextprotocol/inspector 开发）：

pnpm run dev

打开 http://localhost:5173

📚 详细文档

配置

MCP 配置

{
  "mcpServers": {
    "quick-chart-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 300,
      "command": "npx",
      "args": [
        "quick-chart-mcp@1.0.13"
      ],
      "transportType": "stdio"
    }
  }
}

环境配置

创建一个 .env 文件以包含你的凭证：

# Quick Chart 配置
NODE_ENV=optional_development_or_product
QUICK_CHART_DRAW_URL=optional_quick_chart_draw_url
NEED_INSTALL_QUICK_CHART=optional_true_or_false

项目结构

quick-chart-mcp/
├── src/
│   ├── index.ts          # 主入口点
└── package.json
    └── tsconfig.json

可用工具

此 MCP 服务器提供以下 Quick Chart 工具：

• GetChartImgLink - 通过参数获取图表图片链接。
• InstallQuickChart - 在本地安装 quick chart 服务。

安全注意事项

• 使用环境变量存储敏感信息
• 定期监控和审计 AI 代理活动

故障排除

如遇到问题，可验证构建是否成功。

依赖项

图像 API。

贡献

欢迎贡献！请随意提交 Pull Request。步骤如下：

1. 叉克隆仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开 Pull Request

📄 许可证

此项目根据 MIT License 分发。