amCharts 5 MCP Server

amCharts 5 MCP Server

Сервер MCP (Model Context Protocol), предоставляющий ИИ-ассистентам доступ по запросу к полной базе знаний amCharts 5: 140+ страниц документации, 280+ примеров кода и 1000+ справочных материалов по API классов.

Работает с Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + GitHub Copilot и любыми другими ИИ-инструментами, совместимыми с MCP.

Зачем?

Вместо загрузки всего справочника amCharts в контекстное окно ИИ, MCP-сервер позволяет ИИ запрашивать именно то, что нужно — справку по конкретному типу диаграммы, пример кода или поиск по API. Это означает более качественные ответы с меньшими затратами контекста.

Быстрый старт

Самый простой способ — облачный сервер — без установки, достаточно добавить один URL. Предпочитаете запускать самостоятельно? См. раздел Локальная установка ниже.

Облачный сервер (без установки) — рекомендуется

Укажите вашему ИИ-клиенту:

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 или добавьте в его JSON-настройки MCP:

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

Клиенты, поддерживающие только локальные (stdio) серверы (например, Zed, Continue, Amazon Q Developer) — подключитесь к облачному URL через mcp-remote. Используйте это как команду запуска сервера в конфигурации клиента:

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

Например, в конфигурации в стиле command/args:

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

Любой другой MCP-клиент, принимающий URL удаленного сервера, также подойдет — используйте конечную точку /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	Поиск по справочной документации навыков по ключевому слову
search_all	Поиск по всему — документации навыков, полной документации и примерам кода
get_doc	Получить полную страницу документации (например, "charts/xy-chart/axes", "concepts/events")
get_section	Получить конкретный раздел из справочного файла по заголовку
get_quick_start	Получить минимальный рабочий шаблон для любого типа диаграммы
list_examples	Просмотреть все 283 примера, опционально с фильтрацией по категории
get_example	Получить полный код конкретного примера

Примеры использования

После подключения ваш ИИ-ассистент сможет:

• "Построй мне круговую диаграмму" → ИИ вызывает get_quick_start("pie") и адаптирует шаблон
• "Как форматировать метки оси дат?" → ИИ вызывает search_all("date axis label format")
• "Покажи пример диаграммы Сэнки" → ИИ вызывает get_example("examples/flow/sankey-diagram")
• "Какие настройки поддерживает XYChart?" → ИИ вызывает get_doc("reference/xychart")
• "Как интегрировать с React?" → ИИ вызывает get_doc("getting-started/integrations/react")
• "Какие типы диаграмм доступны?" → ИИ вызывает list_chart_types()

Содержание

Сервер включает 1500+ документов:

• 140+ страниц документации — начало работы, руководства по диаграммам, концепции (темы, события, адаптеры, привязка данных, анимации, доступность и т.д.) и руководства по интеграции с фреймворками (React, Angular, Vue, Next.js, Svelte и другие)
• 280+ примеров кода — рабочие демонстрации в 16 категориях, включая столбчатые/линейчатые, линейные/с областями, круговые/кольцевые, карты, иерархии, потоки, радарные/полярные, биржевые, измерительные, диаграммы Ганта, временные шкалы и другие
• 1000+ справочных материалов по API классов — каждый класс в библиотеке amCharts 5 с его настройками, свойствами, методами, событиями и цепочкой наследования
• Курируемый справочник навыков — шаблоны быстрого старта и руководства по конкретным диаграммам из amCharts 5 AI Skill

Лицензия

MIT