astro-docs-mcp - Astro Docs, свежая документация Astro

Когда звать

• Когда агент собирает сайт на Astro и использует приёмы из старых версий, которых в текущей версии уже нет или они работают иначе.
• Когда нужно, чтобы агент сверялся с документацией Astro на каждый вопрос про маршруты, коллекции контента или интеграции.

Что это

Astro быстро меняется. Агент, который писал сайт на Astro по старым данным, может подсунуть устаревшие приёмы: другие настройки, другие названия, способы, которых в текущей версии уже нет. Ошибки всплывают только при сборке.

Astro Docs MCP - официальный сервер самой команды Astro. По README он даёт ИИ-инструментам (Cursor, VS Code, Claude, ChatGPT, Windsurf) доступ к свежей документации в структурированном виде, чтобы они отвечали на вопросы и писали код по актуальным данным. Это то, ради чего его сделали, и для нашего сайта это не теория: ClaudeBase сам собран на Astro.

Как подключить

Сервер удалённый, ничего устанавливать не нужно. По README настройки такие: имя Astro Docs, адрес https://mcp.docs.astro.build/mcp, транспорт http.

В Claude Code (команда из README):

claude mcp add --transport http "Astro docs" https://mcp.docs.astro.build/mcp

В Codex в README команды нет. Строка составлена по справке Codex (параметр --url для HTTP-серверов) и адресу из README. На живом сервере из Codex мы её не прогоняли.

Проверка: в Claude Code открой /mcp и убедись, что сервер подключён. Потом спроси агента, как в текущей версии Astro сделать коллекцию контента из Markdown-файлов. Он должен сделать запрос к серверу и привести ответ по документации.

Ограничения, о которых стоит знать

Сервер использует «потоковый HTTP». Некоторые клиенты умеют только старый SSE, для них нужен локальный посредник. README показывает такой вариант для Windsurf через пакет mcp-remote. Пакет сторонний, ставь его, только если иначе никак.

Репозиторий небольшой и давно не менялся: последний коммит в октябре 2025. Сервер при этом открыт и отвечает; мы проверили, что главная страница сервера отдаёт ответ. Это ещё не значит, что документация внутри всегда свежее вчерашней: насколько часто она обновляется, в README не сказано.

Сервер знает документацию, а твоего проекта не видит.

Лицензия

В репозитории сервера нет файла LICENSE, MIT указана только в package.json. Документация Astro, на которой всё построено, лежит под MIT в репозитории withastro/docs. Для обычного подключения этого достаточно.

Мы сверили описание с README на 22 октября 2026 года. Для документации других технологий есть отдельные серверы, например для MDN и общий Context7. Общий порядок подключения - в статье про MCP в Claude Code.