Сервер присылает шаблон графика нужного типа, например столбцов, линий или круговой диаграммы: для страницы с тегами script или с импортами для сборки, как в проектах на React. Как эти шаблоны выглядят в браузере, мы не проверяли.
По имени класса сервер присылает справку: строку импорта, от кого класс наследуется, и список настроек, у многих из них указано значение по умолчанию. Промпт может попросить агента сверять с ней каждую настройку в коде.
Сервер отдаёт готовые примеры amCharts с полным кодом, от сгруппированных столбцов до панели из пяти графиков. Переделку под твои данные делает агент, на прогоне её не было.
В документации amCharts на сервере есть страницы про язык и форматы, легенду и подсказки при наведении. На прогоне страница про языки пришла целиком, с тем, как подключить файл языка.
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Промпт для агента
Подключи MCP-сервер «amCharts 5» версии 1.7.1. Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог smyslokod.ru, проверено 09.10.2026):
- имя в конфиге: amcharts5
- официальный источник: https://github.com/amcharts/amcharts5-mcp/tree/main
- запуск: npx -y @amcharts/amcharts5-mcp@1.7.1
Правила:
1. Не ставь Node.js, uv или Docker без моего «да». Не хватает - остановись и скажи, что поставить и откуда.
2. Ставь только пакет или адрес из этого промпта. Никаких установочных скриптов из README без моего подтверждения.
3. Перед правкой конфига сделай его резервную копию.
Шаги:
0. Определи, кто ты (Claude Code, Codex или другой агент) и какая у меня система.
1. Проверь окружение: node --version и npx --version (нужен Node.js 18 или новее). Скажи, что нашёл.
2. Проверь, нет ли уже сервера с таким именем: `claude mcp get amcharts5` (в Codex: `codex mcp list`).
3. Подключи сервер:
Claude Code: claude mcp add --scope user --transport stdio amcharts5 -- npx -y @amcharts/amcharts5-mcp@1.7.1
Codex: codex mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcp@1.7.1
Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
4. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. У сервера 11 инструментов, перечисли их. Сделай пробный запрос: «Через amcharts5 дай шаблон кольцевой диаграммы для React на ES-модулях и скажи, какой настройкой делается дырка в середине». Покажи результат.
5. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove amcharts5 --scope user` (в Codex: `codex mcp remove amcharts5`).
Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/mcp/amcharts5#problemy
Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.
Что нужно на компьютере: Node.js 18 или новее.
Ключ: не нужен.
Ключ и аккаунт не нужны, нужен Node.js 18 или новее. При первом запуске npx скачивает пакет из реестра npm, документация лежит внутри него: по данным реестра это около 7 МБ в распакованном виде. Дальше сервер отвечает из этих файлов у тебя на компьютере и в сеть не ходит. У amCharts есть и удалённый адрес, он работает через Cloudflare, и здесь мы его не даём.
Проверь, что работает
Пробный запрос
Через amcharts5 дай шаблон кольцевой диаграммы для React на ES-модулях и скажи, какой настройкой делается дырка в середине
Что должно получиться: Промпт просит агента вызвать get_quick_start с типом pie и форматом esm. Прямой вызов через mcp-probe вернул импорты из @amcharts/amcharts5, код PieChart и PieSeries и таблицу настроек, где дырку для кольца задаёт innerRadius. Как ответит сам агент, мы не проверяли. Если вызова amcharts5 в ответе нет, посмотри командой /mcp, подключён ли сервер.
Что можно сделать
4 сценария
Столбчатый график выручки по месяцам для отчёта
Промпт просит страницу с графиком по твоему файлу. Мы проверили только ответы сервера: get_quick_start по column вернул теги script с cdn.amcharts.com и схему настройки из восьми шагов, где данные задаются последними, а get_example отдал полный код сгруппированных столбцов с легендой. Саму страницу агент на прогоне не собирал.
get_quick_start с chartType column и format html: шаблон страницы.
get_example по examples/column-bar/clustered-column-chart: полный код, если столбцов несколько на месяц.
Промпт
Через подключение amcharts5 возьми шаблон столбчатого графика и сделай страницу sales.html: выручка по месяцам из файла data.json, подписи по-русски, подсказка с суммой при наведении. Сверь названия настроек со справочником сервера, а не по памяти. Логотип amCharts на графике не убирай.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Бесплатная лицензия amCharts 5 требует оставить ссылку-логотип amCharts на графике, поэтому промпт просит его не убирать.
Кольцевая диаграмма долей в кабинете на React
Здесь агенту нужен шаблон для сборки. На прогоне get_quick_start по pie в формате esm за 5 мс прислал импорты из @amcharts/amcharts5, код PieChart и PieSeries и таблицу настроек, где сказано, что кольцо задаёт innerRadius. Компонент React по нему мы не писали.
get_quick_start с chartType pie и format esm.
get_section по SKILL и заголовку Critical rules: на прогоне правило 12 этого раздела требовало вызывать root.dispose(), когда компонент убирают со страницы.
Промпт
Через подключение amcharts5 сделай компонент React с кольцевой диаграммой долей выручки по каналам продаж. Данные приходят в компонент свойством. Возьми шаблон круговой диаграммы в формате ES-модулей и не забудь освобождать график при уходе со страницы, как велит справочник amCharts.
Бесплатно: почта или сразу Телеграм-канал клуба
Подписи дат на оси по-русски
Сервер ответил двумя страницами. get_doc по concepts/locales объяснил, что язык подключается отдельным файлом с кодом языка и региона и задаётся через root.locale, а get_api_reference по DateAxis выдал настройки оси с умолчаниями, среди них dateFormats и tooltipDateFormat. Файл русского языка и подписи на графике мы отдельно не смотрели.
get_doc по пути concepts/locales.
get_api_reference по классу DateAxis.
Промпт
Через подключение amcharts5 выясни, как в amCharts 5 включить русский язык и форматы дат, и поправь график в моём проекте: на оси дат названия месяцев по-русски, во всплывающей подсказке дата в виде 05.03.2026. Покажи, какие строки поменял.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Поиск search_all по словам russian locale первым вернул пример с немецким языком, поэтому в промпте задача сформулирована целиком, без готового поискового запроса.
Панель из нескольких графиков на одной странице
get_example по maps-and-charts-dashboard прислал на прогоне около 34 тысяч знаков кода: тепловая карта мира, кольцо, радар, линия и столбцы. По описанию примера, при наведении на страну подсвечивается её континент, в браузере мы это не смотрели. Под свои данные мы его не переделывали, этот шаг остаётся за агентом.
list_examples с категорией dashboards: два примера.
get_example по examples/dashboards/maps-and-charts-dashboard.
Промпт
Через подключение amcharts5 найди в примерах панель из нескольких графиков и сделай по ней страницу для отчёта: слева линия выручки по дням, справа кольцо долей по товарам, снизу столбцы по менеджерам. Данные возьми из report.json. Лишнее из примера, например карту мира, убери.
Бесплатно: почта или сразу Телеграм-канал клуба
Совет. Весь код примера уходит в разговор агента. Если нужна одна часть, попроси взять только её.
Пример работы
редакция, прогон при проверке 09.10.2026
Задача
Получить шаблон графика для отчёта и сверить настройки со справочником
Промпт
Через подключение amcharts5 возьми шаблон столбчатого графика для страницы и проверь по справочнику, какие у оси дат настройки по умолчанию
Что сделал агент
list_chart_types за 11 мс перечислил семейства графиков, столбцы и линии входят в семейство xy.
get_quick_start по column вернул теги script и схему настройки из восьми шагов с пометкой, что данные задаются последними.
get_api_reference по DateAxis отдал настройки оси: groupData по умолчанию false, groupCount 500, форматы дат.
На тип no-such-chart сервер ответил списком из 12 доступных семейств.
Результат
Все 18 вызовов в двух прогонах заняли от 1 до 133 мс, ключ и сеть серверу не понадобились. Промпт агентом Claude Code не выполнялся, вызовы делал mcp-probe.
Инструменты
11 · описания около 1,8 тыс. токенов
Жёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.
Когда не нужен
Если графики в проекте строятся на другой библиотеке, сервер не поможет: он знает только amCharts 5. И помни про условия самой библиотеки: бесплатно её можно ставить и на коммерческий сайт, пока на графике остаётся ссылка-логотип amCharts. Для графиков без логотипа amCharts продаёт платные лицензии.
Частые проблемы
7
Поиск вернул разделы не про то, что спрашивали
search_all и search_docs ищут по отдельным словам. На прогоне запрос date axis label format дал 1527 совпадений, и первые три были про сохранение графика в JSON, свежие изменения и диаграмму Ганта. Попроси агента брать справку по имени класса через get_api_reference, например DateAxis для оси дат, или открыть страницу документации через get_doc.
«No reference found for ...» и список доступных типов
Агент передал название графика, которого нет в списке сервера. Сервер понимает слова вроде line, column, pie, donut, map, а остальные отклоняет. Пусть агент сначала вызовет list_chart_types и возьмёт название оттуда.
После одного вызова в разговор пришло больше 80 тысяч знаков
get_core_reference отдаёт общий справочник целиком, на прогоне это 81 524 знака. Для одного вопроса хватит get_section с нужным заголовком или поиска search_docs: они возвращают только часть справочника.
Агент не видит инструментов сервера
Клиент не перезапущен после подключения: Claude Code читает подключения при старте сессии. Закрой и открой сессию, потом проверь: claude mcp list.
«spawn npx ENOENT» при запуске
Клиент не видит npx: приложения с иконкой не читают PATH из настроек терминала. Пропиши полный путь к npx. Узнать его: which npx на Mac, where npx на Windows.
«Unsupported engine» или падение при старте
Старая версия Node.js. Нужна 18 или новее, проверить: node --version.
Codex: сервер не успевает запуститься
Codex ждёт запуска 10 секунд, а первый запуск npx скачивает пакет дольше. Во вкладке Codex уже стоит startup_timeout_sec = 30, возьми фрагмент оттуда.
Только то, что агент передаёт в вызов: тип графика, слова поиска, путь страницы документации или имя класса. Файлы проекта, данные для графиков и разговор сервер не читает.
Куда уходят данные
Данные остаются на компьютере.
Что может изменить
Сервер ничего не меняет: инструменты только отдают текст из документации, которая лежит внутри пакета. Код графика в проект записывает сам агент.
Наша проверка
Пакет @amcharts/amcharts5-mcp выпускает amCharts: на него ссылается документация на сайте amcharts.com, исходный код лежит в репозитории amcharts/amcharts5-mcp под лицензией MIT, в официальном реестре MCP сервер записан как io.github.amcharts/amcharts5. Мы прочитали код версии 1.7.1: в нём нет обращений к сети, запуска команд и записи файлов. Инструкции у сервера нет, а в описаниях 11 инструментов и в справочнике, который он отдаёт, нет просьб читать файлы, ключи или что-то скрывать от тебя. В справочнике есть открытый совет агенту, у которого есть выход в сеть, смотреть демо и документацию на amcharts.com. В одноразовой песочнице Ubuntu 24.04.5 мы вызвали все 11 инструментов, всего 18 вызовов, все ответили без ошибок протокола. Попытка открыть путь с ../ к системному файлу получила ответ, что такой страницы нет. Автор не пометил инструменты как безопасные для чтения, поэтому read мы поставили сами, по коду и ответам на прогоне. Соединения записаны: npx обращался только к реестру npm, а сервер, запущенный из уже установленного пакета без npx, не открыл ни одного соединения. База OSV не нашла записей ни по одному из 93 пакетов, которые ставятся вместе с сервером, считая его самого, а npm audit показал ноль уязвимостей. Версия в команде закреплена.
Версия
В командах закреплена версия 1.7.1: ставится ровно то, что мы проверили.
Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
