🚀 Quickchart-server MCP 服务器

Quickchart-server MCP 服务器是一个基于模型上下文协议（Model Context Protocol）的服务器，它使用 TypeScript 编写，可与 QuickChart.io 集成，借助 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 许可证。