amCharts 5 MCP Server

公式

MCPサーバーは、AIアシスタントに1,500以上のamChartsドキュメント、約300のコード例、1000以上のクラスAPIリファレンスへのオンデマンドアクセスを提供します。

amCharts 5 MCPで何ができますか？

チャートクイックスタートテンプレート — 円グラフやサンキーチャートなど、あらゆるチャートタイプの最小限の動作するテンプレートを取得し、自分のコードに適応させることができます。
ドキュメントとサンプル検索 — スキルドキュメント、完全なドキュメント、290以上のコードサンプルをキーワードで横断検索し、関連するガイダンスを見つけられます。
チャートタイプとサンプルの閲覧 — 利用可能なチャートタイプを一覧表示したり、カテゴリで絞り込んだサンプルを閲覧したりして、特定のサンプルの完全なコードを取得できます。
APIリファレンス検索 — 任意のamCharts 5のクラス、インターフェース、関数について、デフォルト値付きの設定、イベント、継承、インポート行を調べられます。
マップ地理データの検出 — 世界、大陸、国、地域、米国議会選挙区のパックを含むマップファイルを、CDNパスとインポートの詳細とともに見つけられます。
フレームワーク統合ガイド — React、Vue、Angular、Svelte、React Nativeの統合に関するドキュメントを取得できます。Next.js、Nuxt、SvelteKitのセットアップも含まれます。

ドキュメント

amCharts 5 MCP Server

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 クライアントの接続先を次に設定します：

https://mcp.amcharts.com/mcp

Claude Code

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

Claude Desktop / claude.ai — 設定 → コネクタ → カスタムコネクタを追加 を開き、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）— 設定 → コネクタ → カスタムコネクタを追加 を開き、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 リファレンス（デフォルト値付きの設定、イベント、継承、import 行）を取得
`list_geodata`	マップ（ジオデータ）ファイル（世界、大陸、国、地域パック、議会ごとの米国下院選挙区パック）を、各ファイルの CDN パス、スクリプトグローバル、ES import とともに検索

使用例

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

「円グラフを作って」 → AI が get_quick_start("pie") を呼び出し、テンプレートを調整
「日付軸のラベルをフォーマットするには？」 → AI が search_all("date axis label format") を呼び出す
「サンキー図の例を見せて」 → 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 ライブラリのすべてのクラス、インターフェース、関数をリリースの型定義から生成（実際のデフォルト値付きの設定（テーマルールを含む）、イベント、プロパティ、データアイテムのフィールド、継承チェーン、import 行）
670 以上のジオデータエントリ — @amcharts/amcharts5-geodata 内のすべてのマップ（list_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 initialize メッセージをセッションのストレージに保持します。このメッセージには、アプリが自身について述べる情報（名前とバージョン、その他アプリが含めるもの）、プロトコルバージョン、アプリの MCP 機能が含まれます。セッションのストレージはすべて、アプリがセッションを終了したとき、または最後のリクエストから 24 時間後に削除されます。
- ログ： サーバーはリクエストログを保持しません（Workers の呼び出しログは無効）。Cloudflare Workers 上で動作し、Cloudflare は配信のために各リクエスト（IP アドレスを含む）を処理します。エラーおよび警告メッセージはログに記録され、最大 7 日間保持されますが、リクエストの内容やツールの引数は含まれません。
npm パッケージ： お使いのコンピューター上で stdio 経由で動作し、amCharts やその他の誰にも何も送信しません。
ポリシーと質問： amCharts プライバシーポリシーを参照するか、contact@amcharts.com までご連絡ください。

ライセンス

MIT