Gongrzhe Quickchart MCP Server

🚀 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 許可證。