Quickchart-server MCP 服务器

这是一个基于模型上下文协议 (Model Context Protocol) 的服务器，用于使用 QuickChart.io 生成图表。该服务器用 TypeScript 编写，提供通过 MCP 工具生成各种图表的功能。

概述

此服务器与 QuickChart.io 的基于 URL 的图表生成服务集成，利用 Chart.js 配置生成图表图像。用户可以通过提供数据和样式参数来生成不同类型的图表，服务器将其转换为图表的 URL 或可下载的图片。

功能

工具

• generate_chart - 通过 QuickChart.io 生成图表 URL

  • 支持多种图表类型：柱状图、折线图、饼图、环形图、雷达图、极坐标面积图、散点图、气泡图、径向仪表盘、速度计
  • 可自定义标签、数据集、颜色和额外选项
  • 返回生成的图表 URL

• download_chart - 将图表图像下载到本地文件中

  • 接收图表配置和输出路径作为参数
  • 将图表图像保存到指定位置

支持的图表类型

• 柱状图 (Bar charts)：用于比较不同类别的数据。
• 折线图 (Line charts)：适合展示数据随时间的变化趋势。
• 饼图 (Pie charts)：显示各部分在整体中所占的比例。
• 环形图 (Doughnut charts)：与饼图类似，但可以更清晰地比较多个类别。
• 雷达图 (Radar charts)：用于比较多个变量的数据。
• 极坐标面积图 (Polar area charts)：展示数据的大小，通过半径表示。
• 散点图 (Scatter plots)：显示两个变量之间的关系。
• 气泡图 (Bubble charts)：在二维平面上展示三个变量的数据。
• 径向仪表盘 (Radial gauge charts)：以仪表盘的形式展示某个指标的值。
• 速度计 (Speedometers)：用于展示数据范围，类似于汽车上的转速表。

安装步骤

使用 npm 安装

npm install quickchart-server-mcp

在 package.json 中使用

在你的项目中添加如下依赖：

{
  "dependencies": {
    "@gongrzhe/quickchart-server-mcp": "^1.0.0"
  }
}

配置示例

基本配置

const server = new QuickChartServer({
  port: 3000,
  chartType: 'bar',
  data: {
    labels: ['January', 'February', 'March'],
    datasets: [{
      label: '销量',
      data: [65, 59, 80]
    }]
  }
});

高级配置

const server = new QuickChartServer({
  port: 3000,
  chartType: 'line',
  data: {
    labels: ['2017', '2018', '2019'],
    datasets: [{
      label: '收入',
      data: [12, 19, 3],
      borderColor: '#ff0000'
    }, {
      label: '支出',
      data: [5, 6, 7],
      borderColor: '#00ff00'
    }]
  },
  options: {
    responsive: true,
    scales: {
      y: {
        beginAtZero: true
      }
    }
  }
});

文档参考资料

• QuickChart 文档
• 图表类型参考

📜 许可证

此项目基于 MIT 许可证。