Amcharts 5 Mcp Server

amCharts 5 MCP サーバー

AI アシスタントが amCharts 5 の完全なナレッジベース（160 ページ以上のドキュメント、290 件以上のコード例、1,300 ページ以上の API リファレンス）に必要なときにアクセスできる MCP（Model Context Protocol） サーバーです。

Claude Code、Claude Desktop、Cursor、Windsurf、VS Code + GitHub Copilot、その他あらゆる MCP 対応 AI ツールで使用できます。

なぜ使うのか？

amCharts のリファレンス全体を AI のコンテキストウィンドウに読み込む代わりに、MCP サーバーを使うと、AI は必要な情報だけを正確に検索できます。たとえば、特定のグラフの種類のリファレンス、コード例、API の検索などです。これにより、コンテキストを無駄にせず、より良い回答を得られます。

クイックスタート

最も簡単なのはホスト型サーバーです。インストールは不要で、URL を 1 つ追加するだけです。自分で実行したい場合は、以下のローカルインストールを参照してください。

ホスト型（インストール不要）— 推奨

AI クライアントに次の URL を設定します。

https://mcp.amcharts.com/mcp

Claude Code

claude mcp add --transport http amcharts5 https://mcp.amcharts.com/mcp

Claude Desktop / claude.ai — 「Settings」→「Connectors」→「Add custom connector」を選択し、https://mcp.amcharts.com/mcp を貼り付けます。

Cursor — .cursor/mcp.json：

{
  "mcpServers": {
    "amcharts5": {
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

VS Code + GitHub Copilot — .vscode/mcp.json：

{
  "servers": {
    "amcharts5": {
      "type": "http",
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "amcharts5": {
      "serverUrl": "https://mcp.amcharts.com/mcp"
    }
  }
}

ChatGPT（コネクター／開発者モードが有効な Plus／Pro／Enterprise）— 「Settings」→「Connectors」→「Add custom connector」を選択し、https://mcp.amcharts.com/mcp を貼り付けます。

Cline（VS Code 拡張機能）— 「MCP Servers」パネルを開き、「Remote Servers」を選択して https://mcp.amcharts.com/mcp を貼り付けるか、MCP 設定 JSON に追加します。

{
  "mcpServers": {
    "amcharts5": {
      "type": "streamableHttp",
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

ローカル（stdio）サーバーのみをサポートするクライアント（例：Zed、Continue、Amazon Q Developer）— mcp-remote を使ってホスト型 URL に接続します。クライアントの設定で、サーバーの実行コマンドとして次を指定します。

npx mcp-remote https://mcp.amcharts.com/mcp

たとえば、command／args 形式の設定では次のようになります。

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.amcharts.com/mcp"]
    }
  }
}

リモートサーバー URL に対応するその他の MCP クライアントでも使用できます。/mcp エンドポイント（Streamable HTTP）または /sse（旧式の SSE）を使用してください。URL のみを指定するクライアントで、コマンドも必要な場合は、上記の mcp-remote ブリッジを使用します。

ローカルインストール（npx）

自分で実行したい場合、サーバーは npm にも公開されており、stdio 経由で実行できます。

Claude Code

すべてのプロジェクトで使用する場合（グローバル、推奨）：

claude mcp add -s user amcharts5 -- npx -y @amcharts/amcharts5-mcp

現在のプロジェクトのみで使用する場合：

claude mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcp

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

Cursor

プロジェクトのルートに .cursor/mcp.json を作成または編集します（グローバルに設定する場合は ~/.cursor/mcp.json）。

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

VS Code + GitHub Copilot

ワークスペースに .vscode/mcp.json を作成または編集します。

{
  "servers": {
    "amcharts5": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

その他の MCP 対応ツール

MCP をサポートするその他のツール（Cline、Continue、Amazon Q、Zed など）では、次を実行するように設定します。

npx -y @amcharts/amcharts5-mcp

ローカルで実行する（開発用）

git clone https://github.com/amcharts/amcharts5-mcp.git
cd amcharts5-mcp
npm install
npm start

利用可能なツール

ツール	説明
get_core_reference	amCharts 5 のコアドキュメント（セットアップ、テーマ、色、イベント、よくある落とし穴）を取得します
get_chart_reference	チャートの種類（例：「pie」、「sankey」、「xy」）の完全なリファレンスを取得します
list_chart_types	利用可能なすべてのチャートの種類とキーワードを一覧表示します
search_docs	スキルのリファレンスドキュメントをキーワードで検索します（scope: "all" を指定すると、完全なドキュメント、API リファレンス、例も対象になります）
search_all	スキルのドキュメント、完全なドキュメント、コード例など、すべてを横断して検索します
get_doc	ドキュメントページ全体を取得します（例：「charts/xy-chart/axes」、「concepts/events」）
get_section	リファレンスファイルから、見出しで指定したセクションを取得します
get_quick_start	任意のチャートの種類の、最小限の動作するテンプレートを取得します
list_examples	すべての 290 件以上の例を参照します。カテゴリで絞り込むこともできます
get_example	特定の例のコード全体を取得します
get_api_reference	クラス、インターフェース、関数の API リファレンス（デフォルト値を含む設定、イベント、継承、インポート行）を取得します
list_geodata	世界、大陸、国、地域別パック、米国の連邦議会選挙区別パックなど、地図（ジオデータ）ファイルを検索します。各ファイルの CDN パス、スクリプトのグローバル名、ES インポートも確認できます

使用例

接続すると、AI アシスタントは次のことができます。

• 「円グラフを作成して」 → AI が get_quick_start("pie") を呼び出し、テンプレートを調整します
• 「日付軸のラベルの書式を設定するには？」 → AI が search_all("date axis label format") を呼び出します
• 「Sankey ダイアグラムの例を見せて」 → AI が get_example("examples/flow/sankey-diagram") を呼び出します
• 「XYChart ではどのような設定を利用できますか？」 → AI が get_doc("reference/xychart") を呼び出します
• 「React と統合するには？」 → AI が get_doc("getting-started/integrations/react") を呼び出します。このページでは @amcharts/amcharts5-react パッケージについて説明しています
• 「利用できるチャートの種類は？」 → AI が list_chart_types() を呼び出します
• 「現在の米国連邦議会選挙区を地図に表示して」 → AI が list_geodata("congressional whole country") を呼び出します

コンテンツ

サーバーには 1,800 件以上のドキュメントが含まれています。

• 160 件以上のドキュメントページ — 入門ガイド、チャートガイド、概念（テーマ、イベント、アダプター、データバインディング、アニメーション、アクセシビリティなど）、および amCharts の React、Vue、Angular、Svelte、React Native 向けパッケージのフレームワーク統合ガイド（Next.js、Nuxt、SvelteKit、React Router、Remix 3 を含む）
• 290 件以上のコード例 — 棒／縦棒、折れ線／面、円／ドーナツ、マップ、階層、フロー、レーダー／ポーラー、株価、ゲージ、ガント、タイムラインなど、16 カテゴリにわたる動作するデモ
• 1,300 件以上の API リファレンスページ — リリースの型定義から生成された、amCharts 5 ライブラリのすべてのクラス、インターフェース、関数。実際のデフォルト値（テーマルールを含む）を備えた設定、イベント、プロパティ、データ項目のフィールド、継承チェーン、インポート行を掲載しています
• 670 件以上のジオデータ項目 — list_geodata で利用できる @amcharts/amcharts5-geodata のすべての地図
• 厳選されたスキルリファレンス — amCharts 5 AI Skill のクイックスタートテンプレートとチャート別ガイド

セキュリティ

• 読み取り専用のツールです。 すべてのツールは同梱されている amCharts のドキュメントを読み取り、テキストを返します。ファイルへの書き込み、コマンドの実行、URL の取得を行うツールはありません。
• ホストされたエンドポイントは、設計上、認証を必要としません。 https://mcp.amcharts.com/mcp は amcharts.com と同じ公開ドキュメントを提供します。背後にアカウント、API キー、ユーザーデータ、書き込み操作はありません。
  • Cloudflare Workers 上で実行されます。
  • MCP エージェントのフレームワークで必要とされるため、MCP セッションの状態は Durable Object に保持されます。セッション終了時、または最後のリクエストから24時間後に削除されます。
  • リクエストごとのログ（Workers の呼び出しログ）は無効になっています。エラーメッセージのみが記録され、ツールの引数は含まれません。以下の「プライバシー」をご覧ください。
• ローカルインストール。 npm パッケージはお使いのマシンで stdio 経由で実行され、パッケージに同梱されたコンテンツのみを読み取ります。ネットワークリクエストは行いません。実行時の依存関係は @modelcontextprotocol/sdk と zod のみです。
• メンテナー用スクリプト。 scripts/ 内のスクリプト（デモおよびドキュメントのスクレイパー、API リファレンスの生成ツール）は npm パッケージの一部ではなく、サーバー上で実行されることもありません。
• 脆弱性の報告： https://www.amcharts.com/report-vulnerability/

プライバシー

ホストされたサーバーも npm パッケージも、アカウントを必要とせず、個人データを求めることもありません。

• ホストされたサーバー（https://mcp.amcharts.com/mcp）：
  • AI アプリから送信される内容： 検索語句、チャートの種類、ドキュメントのパスです。これらは回答の作成にのみ使用され、ログに記録されたり保存されたりすることはありません。レスポンスは、配信されるまで（切断されたストリームを再開できるように）セッションのストレージに保持され、その後削除されます。
  • セッション記録： AI アプリが接続すると、サーバーは MCP の初期化メッセージをセッションのストレージに保持します。このメッセージには、アプリが自身について通知する内容（名前やバージョン、およびアプリが含めるその他の情報）、プロトコルのバージョン、アプリの MCP 機能が含まれます。アプリがセッションを終了したとき、または最後のリクエストから24時間後に、セッションのストレージ全体が削除されます。
  • ログ： サーバーはリクエストログを保持しません（Workers の呼び出しログは無効になっています）。Cloudflare Workers 上で実行されるため、Cloudflare はリクエストを配信する目的で、IP アドレスを含む各リクエストを処理します。エラーおよび警告メッセージは記録され、最長7日間保持されますが、リクエストの内容やツールの引数は含まれません。
• npm パッケージ： お使いのコンピューター上で stdio 経由で実行され、amCharts を含む他の相手にも何も送信しません。
• ポリシーとお問い合わせ： amCharts のプライバシーポリシーをご覧いただくか、[email protected] までご連絡ください。

ライセンス

MIT