this is fork of Quickchart-MCP-Server

Quickchart-MCP-Server のフォークです

quickchart-server MCP サーバー

QuickChart.io を使用してチャートを生成する Model Context Protocol サーバーです。

チャート生成機能を提供する TypeScript ベースの MCP サーバーです。MCP ツールを通じて、さまざまな種類のチャートを作成できます。

概要

このサーバーは、QuickChart.io の URL ベースのチャート生成サービスと連携し、Chart.js の設定を使ってチャート画像を作成します。データとスタイルのパラメーターを指定すると、さまざまな種類のチャートを生成でき、サーバーはそれをチャート URL またはダウンロード可能な画像に変換します。

機能

ツール

• generate_chart - QuickChart.io を使用してチャート URL を生成します

  • 棒グラフ、折れ線グラフ、円グラフ、ドーナツグラフ、レーダーチャート、極域グラフ、散布図、バブルチャート、ラジアルゲージ、スピードメーターなど、複数のチャートタイプに対応しています
  • ラベル、データセット、色、追加オプションをカスタマイズできます
  • 生成したチャートの URL を返します

• download_chart - チャート画像をローカルファイルにダウンロードします

  • チャートの設定と出力先パスをパラメーターとして指定します
  • 指定した場所にチャート画像を保存します

対応するチャートタイプ

• 棒グラフ：カテゴリごとの値を比較します
• 折れ線グラフ：時間の経過に伴う傾向を示します
• 円グラフ：割合データを表示します
• ドーナツグラフ：円グラフに似ていますが、中央が空洞です
• レーダーチャート：多変量データを示します
• 極域グラフ：角度が固定されたセグメントで割合データを表示します
• 散布図：データポイントの分布を示します
• バブルチャート：3 次元データを可視化します
• ラジアルゲージ：範囲内の単一の値を表示します
• スピードメーター：スピードメーター形式で値を表示します

使い方

チャートの設定

このサーバーは Chart.js の設定形式を使用します。基本的な例を以下に示します。

{
  "type": "bar",
  "data": {
    "labels": ["January", "February", "March"],
    "datasets": [{
      "label": "Sales",
      "data": [65, 59, 80],
      "backgroundColor": "rgb(75, 192, 192)"
    }]
  },
  "options": {
    "title": {
      "display": true,
      "text": "Monthly Sales"
    }
  }
}

URL の生成

サーバーは設定を QuickChart URL に変換します。

https://quickchart.io/chart?c={...encoded configuration...}

開発

依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

インストール

インストール

npm install @gongrzhe/quickchart-mcp-server

Smithery 経由でのインストール

Smithery 経由で、Claude Desktop 用の QuickChart Server を自動的にインストールするには：

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"
      ]
    }
  }
}

ドキュメントの参照先

• QuickChart のドキュメント
• チャートタイプのリファレンス

📜 ライセンス

このプロジェクトは MIT License の下でライセンスされています。