amCharts 5 MCP Server

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-сервер позволяет запрашивать только необходимые сведения: описание конкретного типа диаграммы, пример кода или справку по 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 — откройте Settings → Connectors → Add custom connector и вставьте 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 с включённой поддержкой connectors/developer mode) — откройте Settings → Connectors → Add custom connector и вставьте 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, могут подключиться к размещённому серверу с помощью 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`	Поиск по справочной документации skill; параметр `scope: "all"` включает полную документацию, справочник API и примеры
`search_all`	Поиск по всем материалам: документации skill, полной документации и примерам кода
`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 import

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

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

«Создай круговую диаграмму» → AI вызывает get_quick_start("pie") и адаптирует шаблон
«Как задать формат подписей оси дат?» → AI вызывает search_all("date axis label format")
«Покажи пример диаграммы Sankey» → 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 категориях, включая столбчатые диаграммы, линейные диаграммы и диаграммы с областями, круговые и кольцевые диаграммы, карты, иерархии, диаграммы потоков, радарные и полярные диаграммы, биржевые графики, индикаторы, диаграммы Ганта, временные шкалы и многое другое
Более 1 300 страниц справочника API — все классы, интерфейсы и функции библиотеки amCharts 5, созданные на основе типов из релиза: параметры с фактическими значениями по умолчанию (включая правила тем), события, свойства, поля элементов данных, цепочка наследования и строка импорта
Более 670 записей геоданных — все карты из @amcharts/amcharts5-geodata, доступные через list_geodata
Подобранный справочник skill — шаблоны для быстрого старта и руководства по отдельным типам диаграмм из AI Skill для amCharts 5

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

Инструменты доступны только для чтения. Каждый инструмент читает документацию 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