amCharts 5 MCP Server

MCP-сервер amCharts 5

MCP (Model Context Protocol) сервер, который даёт AI-ассистентам доступ по запросу к полной базе знаний amCharts 5: 160+ страниц документации, 290+ примеров кода и 1 300+ страниц справочника API.

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

Зачем?

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

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

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

Размещённый (без установки) — рекомендуется

Укажите в вашем 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 или добавьте в 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	Поиск по справочным документам навыка по ключевому слову (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 для класса, интерфейса или функции — настройки со значениями по умолчанию, события, наследование и строку импорта
list_geodata	Найти файлы карт (геоданных) — мир, континенты, страны, региональные наборы и наборы избирательных округов США по каждому созыву Конгресса — с CDN-путём каждого файла, глобальной переменной скрипта и ES-импортом

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

После подключения ваш 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 категориях, включая столбчатые/линейчатые, линейные/площадные, круговые/кольцевые, карты, иерархии, потоки, радарные/полярные, биржевые, индикаторные, Gantt, временные шкалы и другие
• 1 300+ страниц справочника API — каждый класс, интерфейс и функция библиотеки amCharts 5, сгенерированные из типизаций релиза: настройки с их реальными значениями по умолчанию (включая правила тем), события, свойства, поля элементов данных, цепочка наследования и строка импорта
• 670+ записей геоданных — каждая карта в @amcharts/amcharts5-geodata, для list_geodata
• Отобранный справочник навыка — шаблоны быстрого старта и руководства по конкретным диаграммам из amCharts 5 AI Skill

Безопасность

• Инструменты только для чтения. Каждый инструмент читает встроенную документацию amCharts и возвращает текст. Ни один инструмент не записывает файлы, не выполняет команды и не загружает URL-адреса.
• Размещённый эндпоинт по замыслу не имеет аутентификации. https://mcp.amcharts.com/mcp предоставляет ту же публичную документацию, что и amcharts.com. За ним нет ни аккаунтов, ни API-ключей, ни пользовательских данных, ни операций записи.
  • Он работает на Cloudflare Workers.
  • Состояние MCP-сессии хранится в Durable Object, как требует фреймворк MCP-агентов. Оно удаляется по завершении сессии или через 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 в хранилище сессии. Это сообщение содержит то, что приложение сообщает о себе (его имя и версию, а также всё остальное, что оно туда помещает), версию протокола и возможности MCP приложения. Всё хранилище сессии удаляется, когда приложение завершает сессию, или через 24 часа после последнего запроса.
  • Логи: сервер не ведёт логи запросов (логи вызовов Workers отключены). Он работает на Cloudflare Workers, и Cloudflare обрабатывает каждый запрос, включая его IP-адрес, для его доставки. Сообщения об ошибках и предупреждения логируются и хранятся до 7 дней; они не содержат содержимого запросов или аргументов инструментов.
• Пакет npm: он работает на вашем компьютере через stdio и ничего не отправляет в amCharts или кому-либо ещё.
• Политика и вопросы: см. политику конфиденциальности amCharts или напишите на contact@amcharts.com.

Лицензия

MIT