Skip to main content
Glama
amCharts 5 MCP Server

amCharts 5 MCP Server

Official
by amcharts

amCharts 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-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

スキルリファレンスドキュメントをキーワードで検索

search_all

すべてを横断検索 — スキルドキュメント、完全なドキュメント、コード例

get_doc

完全なドキュメントページを取得(例: "charts/xy-chart/axes", "concepts/events")

get_section

リファレンスファイルから見出しを指定して特定のセクションを取得

get_quick_start

任意のチャートタイプの最小限の動作テンプレートを取得

list_examples

283 個の全例を閲覧(カテゴリによるフィルタリングも可能)

get_example

特定の例の完全なコードを取得

使用例

接続すると、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 tools
get_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'.

NameRequiredDescriptionDefault
classNameYesamCharts 5 class name, e.g. 'XYCursor', 'Tooltip', 'PieSeries', 'ColumnSeries', 'AxisRendererX'. Casing/punctuation are ignored.
includePrivateNoAlso 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.

NameRequiredDescriptionDefault
chartTypeYesChart 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.

NameRequiredDescriptionDefault

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.

NameRequiredDescriptionDefault
pathYesDoc 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.

NameRequiredDescriptionDefault
pathYesExample 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.

NameRequiredDescriptionDefault
formatNoOutput format: 'html' for a full HTML page with CDN scripts, 'esm' for ES module importshtml
chartTypeYesChart 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').

NameRequiredDescriptionDefault
fileYesDoc 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.
headingYesSection 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

NameRequiredDescriptionDefault

No parameters

list_examplesAInspect

List all available amCharts 5 code examples, optionally filtered by category.

NameRequiredDescriptionDefault
categoryNoFilter 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.

NameRequiredDescriptionDefault
queryYesSearch query, e.g. 'react integration', 'date axis formatting', 'stacked bar example'
maxResultsNoMaximum 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.

NameRequiredDescriptionDefault
queryYesSearch query, e.g. 'legend', 'axis label rotation', 'tooltip format', 'data processor'
scopeNo'skill' (default) searches only the curated skill docs; 'all' also searches the extended docs / per-class API reference where settings and defaults live.skill
maxResultsNoMaximum number of results to return (default 5)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 11 tool updatesv1.7.1
    • First observedget_api_reference
    • First observedget_chart_reference
    • First observedget_core_reference
    • First observedget_doc
    • First observedget_example
    • First observedget_quick_start
    • First observedget_section
    • First observedlist_chart_types
    • First observedlist_examples
    • First observedsearch_all
    • First observedsearch_docs

TDQS

A4/5.0

Scored across 11 tools

Disambiguation4/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness5/5

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

ActivityMaintained
ResponsivenessNo recent community issues

Related MCP Connectors

Related MCP Servers