amCharts 5 MCP Server
OfficialamCharts 5 MCP サーバー
MCP (Model Context Protocol) サーバーは、AI アシスタントが amCharts 5 のナレッジベース全体(140 以上のドキュメントページ、280 以上のコード例、1,000 以上のクラス API リファレンス)にオンデマンドでアクセスできるようにします。
Claude Code、Claude Desktop、Cursor、Windsurf、VS Code + GitHub Copilot、その他 MCP 対応の AI ツールで動作します。
なぜこれが必要なのか?
amCharts のリファレンス全体を AI のコンテキストウィンドウに読み込む代わりに、この MCP サーバーを使用することで、AI は必要な情報だけを正確にクエリできます(特定のチャートタイプの参照、コード例、API 検索など)。これにより、コンテキストの無駄を省き、より良い回答を得ることができます。
Related MCP server: Dedalus MCP Documentation Server
クイックスタート
Claude Code
すべてのプロジェクト用(グローバル、推奨):
claude mcp add -s user amcharts5 -- npx -y @amcharts/amcharts5-mcp現在のプロジェクトのみ用:
claude mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcpClaude 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利用可能なツール
ツール | 説明 |
| amCharts 5 のコアドキュメントを取得 — セットアップ、テーマ、色、イベント、一般的な落とし穴 |
| チャートタイプの完全なリファレンスを取得(例: "pie", "sankey", "xy") |
| 利用可能なすべてのチャートタイプとキーワードを一覧表示 |
| スキルリファレンスドキュメントをキーワードで検索 |
| すべてを横断検索 — スキルドキュメント、完全なドキュメント、コード例 |
| 完全なドキュメントページを取得(例: "charts/xy-chart/axes", "concepts/events") |
| リファレンスファイルから見出しを指定して特定のセクションを取得 |
| 任意のチャートタイプの最小限の動作テンプレートを取得 |
| 283 個の全例を閲覧(カテゴリによるフィルタリングも可能) |
| 特定の例の完全なコードを取得 |
使用例
接続すると、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")を呼び出す「どのようなチャートタイプが利用可能ですか?」 → AI が
list_chart_types()を呼び出す
コンテンツ
このサーバーには 1,500 以上のドキュメントが含まれています:
140 以上のドキュメントページ — 入門ガイド、チャートガイド、コンセプト(テーマ、イベント、アダプター、データバインディング、アニメーション、アクセシビリティなど)、フレームワーク統合ガイド(React、Angular、Vue、Next.js、Svelte など)
280 以上のコード例 — 16 カテゴリにわたる動作デモ(カラム/バー、ライン/エリア、円/ドーナツ、マップ、階層、フロー、レーダー/ポーラー、ストック、ゲージ、ガント、タイムラインなど)
1,000 以上のクラス API リファレンス — amCharts 5 ライブラリ内のすべてのクラス(設定、プロパティ、メソッド、イベント、継承チェーンを含む)
厳選されたスキルリファレンス — amCharts 5 AI Skill からのクイックスタートテンプレートとチャート固有のガイド
ライセンス
MIT
Available Tools
11 toolsget_api_referenceAInspect
Get the per-class API reference for an amCharts 5 class — the class page PLUS its settings table (with DEFAULTS) and, optionally, its private/read-only settings. This is the authoritative source for exact setting names and default values (e.g. tooltip background cornerRadius, axis tick visible default). Pass a class name in any casing, e.g. 'XYCursor', 'Tooltip', 'PieSeries', 'AxisRendererX'.
| Name | Required | Description | Default |
|---|---|---|---|
| className | Yes | amCharts 5 class name, e.g. 'XYCursor', 'Tooltip', 'PieSeries', 'ColumnSeries', 'AxisRendererX'. Casing/punctuation are ignored. | |
| includePrivate | No | Also include the private (read-only / internal) settings table. Default false. |
get_chart_referenceAInspect
Get the full reference documentation for a specific amCharts 5 chart type. Use list_chart_types first to see available types.
| Name | Required | Description | Default |
|---|---|---|---|
| chartType | Yes | Chart type keyword, e.g. 'pie', 'sankey', 'xy', 'treemap', 'map', 'radar', 'stock', 'gantt', 'venn', 'wordcloud', 'timeline', 'flow', 'hierarchy', 'ui-elements' |
get_core_referenceAInspect
Get the core amCharts 5 reference (SKILL.md) — covers setup, colors, themes, legends, tooltips, events, data, adapters, disposal, and common pitfalls. Read this first before any chart-specific reference.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
get_docAInspect
Get a full documentation page — an extended doc by path, or a skill file by 'skill/'. Accepts the source label exactly as search_docs / search_all print it. Use search_all first to find the right path.
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Doc path, e.g. 'charts/xy-chart/cursor', 'concepts/events', 'getting-started/integrations/react', 'reference/xycursor' (per-class API), or a skill file such as 'skill/SKILL.md' / 'skill/xy'. For a class's full settings + defaults prefer get_api_reference. |
get_exampleAInspect
Get the full code for a specific amCharts 5 example/demo. Use list_examples or search_all to find the path.
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Example path, e.g. 'examples/flow/sankey-diagram', 'examples/pie-donut/donut-chart', 'examples/maps/drill-down-map' |
get_quick_startAInspect
Get a quick-start template for a specific chart type — a minimal working example ready to customize.
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | Output format: 'html' for a full HTML page with CDN scripts, 'esm' for ES module imports | html |
| chartType | Yes | Chart type, e.g. 'pie', 'line', 'bar', 'map', 'sankey', 'treemap' |
get_sectionAInspect
Get the FULL text of one section of a doc by heading — use it to expand a truncated search_docs / search_all result. file accepts the source label exactly as search results print it ('skill/SKILL.md', 'skill/xy', 'extended/charts/xy-chart/cursor', 'reference/xycursor') as well as a bare skill file name ('SKILL', 'xy', 'map').
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | Doc identifier: a skill file ('SKILL', 'xy', 'pie', 'map') or a source label from search results ('skill/SKILL.md', 'extended/concepts/events', 'reference/xycursor'). '.md' and 'skill/' / 'extended/' prefixes are optional. | |
| heading | Yes | Section heading to retrieve (case-insensitive substring), e.g. 'Core setup pattern', 'Axis types', 'Common pitfalls', 'Recent API changes' |
list_chart_typesAInspect
List all amCharts 5 chart types with their categories and reference file names
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
list_examplesAInspect
List all available amCharts 5 code examples, optionally filtered by category.
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | Filter by category, e.g. 'column-bar', 'line-area', 'pie-donut', 'maps', 'flow', 'hierarchy', 'stock', 'gantt', 'gauges', 'radar-polar', 'timeline', 'funnel-pyramid'. Omit to list all categories. |
search_allAInspect
Search across ALL amCharts 5 content: skill references, full documentation, and code examples. Use this for broad searches across everything.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query, e.g. 'react integration', 'date axis formatting', 'stacked bar example' | |
| maxResults | No | Maximum results (default 10) |
search_docsAInspect
Search the curated amCharts 5 skill docs (SKILL.md + chart references) for a keyword or topic, returning matching sections ranked by relevance. NOTE: by default this scans ONLY the skill layer. The per-class API reference and per-setting DEFAULTS (e.g. tooltip background cornerRadius, axis tick visible default, cursor line strokeDasharray) live in the extended docs — pass scope:'all' here, or use search_all / get_api_reference / get_doc, to reach them.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query, e.g. 'legend', 'axis label rotation', 'tooltip format', 'data processor' | |
| scope | No | 'skill' (default) searches only the curated skill docs; 'all' also searches the extended docs / per-class API reference where settings and defaults live. | skill |
| maxResults | No | Maximum number of results to return (default 5) |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
11 tool updates
v1.7.1- First observed
get_api_reference - First observed
get_chart_reference - First observed
get_core_reference - First observed
get_doc - First observed
get_example - First observed
get_quick_start - First observed
get_section - First observed
list_chart_types - First observed
list_examples - First observed
search_all - First observed
search_docs
TDQS
Scored across 11 tools
Each tool has a fairly distinct retrieval target (search, full doc, API reference, examples, chart types, sections), but there is real overlap: search_all vs search_docs (which can scope:'all') and get_doc vs get_section vs get_core_reference all fetch documentation content. The detailed descriptions do a good job steering the agent, keeping confusion to a couple of edge pairs.
Names follow a clean, predictable verb_noun pattern: search_all/search_docs, get_doc/get_section/get_example/get_api_reference, list_examples/list_chart_types. No mixed conventions or vague verbs.
11 tools is well-scoped for a documentation/reference server, with each tool earning its place across discovery (search, list) and retrieval (get) roles. Neither bloated nor thin.
The surface covers the full documentation workflow: broad and scoped search, full docs, per-class API references with defaults, examples, chart-type listings, core skill reference, and quick-start templates. No obvious dead ends for an agent exploring amCharts 5.
Maintenance
Related MCP Connectors
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
An MCP server that gives your AI access to the source code and docs of all public github repos
MCP server for agentverse documentation, generated by doc2mcp.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to access up-to-date documentation for Python libraries like LangChain, LlamaIndex, and OpenAI through dynamic fetching from official sources.1MIT
- AlicenseAqualityDmaintenanceAn MCP server that serves documentation and enables AI-powered search, Q\&A, and document analysis for developer tools and guides.54MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.15 npmMIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI coding assistants access to up-to-date API documentation via RAG by crawling documentation sites, indexing them into a vector store, and enabling semantic queries.MIT