Gongrzhe Quickchart MCP Server

🚀 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)：2 つの変数間の関係を示します。
• バブルチャート (Bubble charts)：2 次元平面上で 3 つの変数のデータを表示します。
• ラジアルゲージ (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 ライセンスの下で提供されています。