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 多份代码示例以及 1000 多份类 API 参考。

适用于 Claude Code、Claude Desktop、Cursor、Windsurf、VS Code + GitHub Copilot 以及任何其他兼容 MCP 的 AI 工具。

为什么使用它?

与其将整个 amCharts 参考资料加载到 AI 的上下文窗口中,不如让 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()

内容

该服务器包含 1500 多份文档:

  • 140 多篇文档页面 — 入门指南、图表指南、概念(主题、事件、适配器、数据绑定、动画、可访问性等)以及框架集成指南(React、Angular、Vue、Next.js、Svelte 等)

  • 280 多份代码示例 — 涵盖 16 个类别的演示,包括柱状图/条形图、折线图/面积图、饼图/环形图、地图、层级图、流向图、雷达图/极坐标图、股票图、仪表盘、甘特图、时间轴等

  • 1000 多份类 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'.

Inputs: className (required), includePrivate.

get_chart_referenceAInspect

Get the full reference documentation for a specific amCharts 5 chart type. Use list_chart_types first to see available types.

Inputs: chartType (required).

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.

Inputs: no named 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.

Inputs: path (required).

get_exampleAInspect

Get the full code for a specific amCharts 5 example/demo. Use list_examples or search_all to find the path.

Inputs: path (required).

get_quick_startAInspect

Get a quick-start template for a specific chart type — a minimal working example ready to customize.

Inputs: chartType (required), format.

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').

Inputs: file (required), heading (required).

list_chart_typesAInspect

List all amCharts 5 chart types with their categories and reference file names

Inputs: no named parameters.

list_examplesAInspect

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

Inputs: category.

search_allAInspect

Search across ALL amCharts 5 content: skill references, full documentation, and code examples. Use this for broad searches across everything.

Inputs: query (required), maxResults.

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.

Inputs: query (required), scope, maxResults.

Tool Schema Changelog

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

Loading tool schema changelog…

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers