Quick Chart MCP Server

Quick Chart MCP 服务

一个提供图表工具的模型上下文协议（MCP）服务，可通过标准化接口与 quick chart 交互。此实现基于图表定义，支持用户无缝打开 quick chart 页面。

概述

此 MCP 服务提供以下工具：

• 与 Quick Chart 交互

该服务实现了模型上下文协议规范，为 AI Agent 标准化图表交互。

前置条件

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

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 quick-chart-mcp：

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

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

# Install globally
npm install -g quick-chart-mcp

# Or install locally in your project
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": [
        "[email protected]"
      ],
      "transportType": "stdio"
    }
  }
}

环境设置

创建 .env 文件并填写凭据：

# Quick Chart Configuration
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          # Main entry point
├── package.json
└── tsconfig.json

可用工具

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

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

安全注意事项

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

故障排除

如果遇到问题：

1. 确认构建成功

依赖项

图片 API。

贡献

欢迎贡献！欢迎提交 Pull Request。

1. Fork 此仓库
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 许可证。