Quickchart-MCP-Server 项目

1- quickchart-server MCP 服务器

image

Quickchart-MCP-Server MCP 服务器

Smithery 徽章

这是一个基于 Model Context Protocol(MCP)的服务器,借助 QuickChart.io 实现图表生成功能。

这是一个基于 TypeScript 的 MCP 服务器,具备图表生成能力。它允许你通过 MCP 工具创建各种类型的图表。

1.1- 概述

该服务器与 QuickChart.io 基于 URL 的图表生成服务集成,使用 Chart.js 配置创建图表图像。用户可以通过提供数据和样式参数来生成各种类型的图表,服务器会将这些参数转换为图表 URL 或可下载的图像。

1.2- 特性

1.2.1- 工具

  • generate_chart - 使用 QuickChart.io 生成图表 URL
    • 支持多种图表类型:条形图、折线图、饼图、环形图、雷达图、极坐标区域图、散点图、气泡图、径向仪表盘、速度计
    • 可通过标签、数据集、颜色和其他选项进行自定义
    • 返回生成图表的 URL
  • download_chart - 将图表图像下载到本地文件
    • 以图表配置和输出路径作为参数
    • 将图表图像保存到指定位置
      image
      image

1.3- 支持的图表类型

  • 条形图:用于比较不同类别之间的值
  • 折线图:用于展示随时间变化的趋势
  • 饼图:用于显示比例数据
  • 环形图:类似于饼图,但中间有空心部分
  • 雷达图:用于展示多变量数据
  • 极坐标区域图:用于以固定角度段显示比例数据
  • 散点图:用于显示数据点的分布
  • 气泡图:用于三维数据可视化
  • 径向仪表盘:用于在一定范围内显示单个值
  • 速度计:用于以速度计样式显示值

1.4- 使用方法

1.4.1- 图表配置

服务器使用 Chart.js 配置格式。以下是一个基本示例:

{
  "type": "bar",
  "data": {
    "labels": ["一月", "二月", "三月"],
    "datasets": [{
      "label": "销售额",
      "data": [65, 59, 80],
      "backgroundColor": "rgb(75, 192, 192)"
    }]
  },
  "options": {
    "title": {
      "display": true,
      "text": "月度销售额"
    }
  }
}

1.4.2- URL 生成

服务器将你的配置转换为 QuickChart URL:

https://quickchart.io/chart?c={...编码后的配置...}

1.5- 开发

安装依赖:

npm install

构建服务器:

npm run build

1.6- 安装

1.6.1- 常规安装

npm install @gongrzhe/quickchart-mcp-server

1.6.2- 通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 QuickChart 服务器,请执行以下命令:

npx -y @smithery/cli install @gongrzhe/quickchart-mcp-server --client claude

要在 Claude Desktop 中使用,请添加服务器配置:

  • 在 macOS 上:~/Library/Application Support/Claude/claude_desktop_config.json
  • 在 Windows 上:%APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "quickchart-server": {
      "command": "node",
      "args": ["/path/to/quickchart-server/build/index.js"]
    }
  }
}

或者

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

1.7- 文档参考

1.8- 📜 许可证

本项目采用 MIT 许可证。