Chart
公式AntVを使用してビジュアルチャートを生成するためのModel Context Protocolサーバー。
Chart MCPで何ができますか?
- 一般的なチャートタイプの生成 — 棒グラフ、折れ線グラフ、円グラフ、散布図、エリアチャートを、
generate_bar_chartやgenerate_line_chartなどのツールでリクエストし、トレンドや比較を可視化します。 - 専門的な可視化の作成 —
generate_sankey_chart、generate_venn_chart、generate_word_cloud_chartなどの高度なチャートをリクエストし、フロー、集合関係、テキスト頻度分析を行います。 - 図やマップの構築 —
generate_flow_diagram、generate_organization_chart、generate_district_mapを使用して、プロセス、階層、地理データ(中国に焦点を当てたマップ)を図示します。 - データ分布の分析 —
generate_boxplot_chart、generate_histogram_chart、generate_violin_chartを生成し、統計的な広がり、外れ値、密度を調べます。 - 表形式データの表示 —
generate_spreadsheetを使用して、通常のテーブルやピボットテーブルをレンダリングし、クロス集計の要約を作成します。
ドキュメント
MCP Server Chart
AntVを使用してチャートを生成するためのModel Context Protocolサーバーです。このMCPサーバーは、_チャート生成_と_データ分析_に使用できます。
これはTypeScriptベースのMCPサーバーで、チャート生成機能を提供します。MCPツールを通じてさまざまな種類のチャートを作成できます。Difyでも使用できます。
📋 目次
- ✨ 特徴
- 🤖 使用方法
- 🎨 スキルの使用方法
- 🚰 SSEまたはStreamableトランスポートでの実行
- 🎮 CLIオプション
- ⚙️ 環境変数
- 📠 プライベートデプロイメント
- 🗺️ 生成レコード
- 🎛️ ツールフィルタリング
- 🔨 開発
- 📄 ライセンス
✨ 特徴
現在26以上のチャートに対応しています。
generate_area_chart:areaチャートを生成し、連続する独立変数におけるデータのトレンドを表示するために使用され、全体的なデータの傾向を観察できます。generate_bar_chart:barチャートを生成し、異なるカテゴリ間の値を比較するために使用され、水平方向の比較に適しています。generate_boxplot_chart:boxplotを生成し、データの分布を表示するために使用され、中央値、四分位数、外れ値を含みます。generate_column_chart:columnチャートを生成し、異なるカテゴリ間の値を比較するために使用され、垂直方向の比較に適しています。generate_district_map-district-mapを生成し、行政区画とデータ分布を表示するために使用されます。generate_dual_axes_chart:dual-axesチャートを生成し、単位や範囲が異なる2つの変数間の関係を表示するために使用されます。generate_fishbone_diagram:fishbone図を生成し、石川図とも呼ばれ、問題の根本原因を特定して表示するために使用されます。generate_flow_diagram:flowchartを生成し、プロセスのステップと順序を表示するために使用されます。generate_funnel_chart:funnelチャートを生成し、異なる段階でのデータ損失を表示するために使用されます。generate_histogram_chart:histogramを生成し、データを区間に分割して各区間のデータポイント数を数えることでデータの分布を表示するために使用されます。generate_line_chart:lineチャートを生成し、時間や別の連続変数にわたるデータのトレンドを表示するために使用されます。generate_liquid_chart:liquidチャートを生成し、データの割合を表示するために使用され、水で満たされた球体の形でパーセンテージを視覚的に表現します。generate_mind_map:mind-mapを生成し、思考プロセスと階層情報を表示するために使用されます。generate_network_graph:networkグラフを生成し、ノード間の関係と接続を表示するために使用されます。generate_organization_chart:organizationalチャートを生成し、組織の構造と人員関係を表示するために使用されます。generate_path_map-path-mapを生成し、POIのルート計画結果を表示するために使用されます。generate_pie_chart:pieチャートを生成し、データの割合を表示するために使用され、各部分のパーセンテージを示す扇形で表されます。generate_pin_map-pin-mapを生成し、POIの分布を示すために使用されます。generate_radar_chart:radarチャートを生成し、多次元データを包括的に表示するために使用され、レーダー形式で複数の次元を示します。generate_sankey_chart:sankeyチャートを生成し、データのフローと量を表示するために使用され、サンキー形式で異なるノード間のデータの移動を表します。generate_scatter_chart:scatterプロットを生成し、2つの変数間の関係を表示するために使用され、座標系上にデータポイントを散布図として表示します。generate_treemap_chart:treemapを生成し、階層データを表示するために使用され、長方形のサイズがデータの値を表す長方形形式でデータを表示します。generate_venn_chart:venn図を生成し、集合間の関係を表示するために使用され、交差、和集合、差集合を含みます。generate_violin_chart:violinプロットを生成し、データの分布を表示するために使用され、箱ひげ図と密度プロットの特徴を組み合わせて、データ分布のより詳細なビューを提供します。generate_word_cloud_chart:word-cloudを生成し、テキストデータ内の単語の頻度を表示するために使用され、フォントサイズが各単語の頻度を示します。generate_spreadsheet: 表形式データを表示するためのspreadsheetまたはピボットテーブルを生成します。「rows」または「values」フィールドが指定された場合はピボットテーブル(クロス集計)としてレンダリングされ、それ以外の場合は通常のテーブルとしてレンダリングされます。
[!NOTE] 上記の地理的可視化チャート生成ツールはAMapサービスを使用しており、現在は中国国内の地図生成のみをサポートしています。
🤖 使用方法
Desktop APP(Claude、VSCode、Cline、Cherry Studio、Cursorなど)で使用するには、以下のMCPサーバー設定を追加してください。Macシステムの場合:
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"]
}
}
}
Windowsシステムの場合:
{
"mcpServers": {
"mcp-server-chart": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@antv/mcp-server-chart"]
}
}
}
また、HTTP、SSEプロトコルを使用してaliyun、modelscope、glama.ai、smithery.aiなどでも使用できます。
🎨 スキルの使用方法
スキル対応のAI IDE(Claude Codeなど)を使用している場合は、chart-visualizationスキルを使用して、最適なチャートタイプを自動的に選択し、可視化を生成できます。
https://github.com/antvis/chart-visualization-skillsからスキルを追加できます:
npx skills add antvis/chart-visualization-skills
次に、データを提供するか、希望する可視化を説明してください。スキルが25以上のチャートタイプからインテリジェントに選択し、チャートを生成します。
🚰 SSEまたはStreamableトランスポートでの実行
直接実行
パッケージをグローバルにインストールします。
npm install -g @antv/mcp-server-chart
好みのトランスポートオプションでサーバーを実行します:
# For SSE transport (default endpoint: /sse)
mcp-server-chart --transport sse
# For Streamable transport with custom endpoint
mcp-server-chart --transport streamable
その後、以下のアドレスでサーバーにアクセスできます:
- SSEトランスポート:
http://localhost:1122/sse - Streamableトランスポート:
http://localhost:1122/mcp
Dockerデプロイ
dockerディレクトリに入ります。
cd docker
docker-composeを使用してデプロイします。
docker compose up -d
その後、以下のアドレスでサーバーにアクセスできます:
- SSEトランスポート:
http://localhost:1123/sse - Streamableトランスポート:
http://localhost:1122/mcp
🎮 CLIオプション
MCPサーバーを実行する際に、以下のCLIオプションも使用できます。-HでCLIを実行してコマンドオプションを確認できます。
MCP Server Chart CLI
Options:
--transport, -t Specify the transport protocol: "stdio", "sse", or "streamable" (default: "stdio")
--host, -h Specify the host for SSE or streamable transport (default: localhost)
--port, -p Specify the port for SSE or streamable transport (default: 1122)
--endpoint, -e Specify the endpoint for the transport:
- For SSE: default is "/sse"
- For streamable: default is "/mcp"
--help, -H Show this help message
⚙️ 環境変数
| 変数 | 説明 | デフォルト | 例 |
|---|---|---|---|
VIS_REQUEST_SERVER | プライベートデプロイメント用のカスタムチャート生成サービスURL | https://antv-studio.alipay.com/api/gpt-vis | https://your-server.com/api/chart |
SERVICE_ID | チャート生成レコード用のサービス識別子 | - | your-service-id-123 |
DISABLED_TOOLS | 無効にするツール名のカンマ区切りリスト | - | generate_fishbone_diagram,generate_mind_map |
📠 プライベートデプロイメント
MCP Server Chartはデフォルトで無料のチャート生成サービスを提供します。プライベートデプロイメントのニーズがあるユーザーは、VIS_REQUEST_SERVERを使用して独自のチャート生成サービスをカスタマイズできます。
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"],
"env": {
"VIS_REQUEST_SERVER": "<YOUR_VIS_REQUEST_SERVER>"
}
}
}
}
AntVのプロジェクトGPT-Vis-SSRを使用して、プライベート環境にHTTPサービスをデプロイし、env VIS_REQUEST_SERVERを通じてURLアドレスを渡すことができます。
- メソッド:
POST - パラメータ:
GPT-Vis-SSRに渡されてレンダリングされます。例:{ "type": "line", "data": [{ "time": "2025-05", "value": 512 }, { "time": "2025-06", "value": 1024 }] }。 - 戻り値: HTTPサービスの戻りオブジェクト。
- success:
booleanチャート画像の生成が成功したかどうか。 - resultObj:
stringチャート画像のURL。 - errorMessage:
stringsuccess = falseの場合、エラーメッセージを返します。
- success:
[!NOTE] プライベートデプロイメントソリューションは現在、地理的可視化チャート生成をサポートしていません。対象外の3つのツール:
geographic-district-map、geographic-path-map、geographic-pin-map。
🗺️ 生成レコード
デフォルトでは、ユーザーは自分で結果を保存する必要がありますが、チャート生成レコードを表示するためのサービスも提供しています。これには、ユーザーが自分でサービス識別子を生成して設定する必要があります。
Alipayでスキャンしてミニプログラムを開き、個人のサービス識別子を生成します(下の「マイ」メニューをクリックし、「マイサービス」ページに入り、「生成」ボタンをクリックし、成功後に「コピー」ボタンをクリックします):
次に、MCPサーバー設定にSERVICE_ID環境変数を追加する必要があります。例えば、Macの設定は以下のとおりです(Windowsシステムの場合は、env変数を追加するだけです):
{
"mcpServers": {
"AntV Map": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"],
"env": {
"SERVICE_ID": "***********************************"
}
}
}
}
MCPサーバー設定を更新した後、AIクライアントアプリケーションを再起動し、MCPサーバーが正常に起動して接続されているか再度確認する必要があります。その後、地図の生成を再度試すことができます。生成が成功したら、ミニプログラムの「マイマップ」ページで地図の生成レコードを表示できます。
🎛️ ツールフィルタリング
DISABLED_TOOLS環境変数を使用して、特定のチャート生成ツールを無効にできます。これは、特定のツールがMCPクライアントと互換性の問題がある場合や、利用可能な機能を制限したい場合に便利です。
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"],
"env": {
"DISABLED_TOOLS": "generate_fishbone_diagram,generate_mind_map"
}
}
}
}
フィルタリングに使用できるツール名 ✨ 特徴を参照してください。
🔨 開発
依存関係をインストール:
npm install
サーバーをビルド:
npm run build
MCPサーバーを起動:
npm run start
SSEトランスポートでMCPサーバーを起動:
node build/index.js -t sse
StreamableトランスポートでMCPサーバーを起動:
node build/index.js -t streamable
📄 ライセンス
MIT@AntV。