mdn-mcp - MDN, справочник по вебу для агента

Когда звать

• Когда агент пишет вёрстку или скрипт и путает, какие свойства CSS, методы JavaScript и функции браузера уже поддерживаются.
• Когда нужна проверка по справочнику: можно ли использовать возможность в Safari и Firefox, а не только в Chrome.

Что это

MDN Web Docs - главный справочник по веб-технологиям: HTML, CSS, JavaScript, браузерные интерфейсы. Его ведёт Mozilla вместе с сообществом. Агент знает MDN по обучающим данным, но справочник меняется: появляются новые свойства, меняется поддержка в браузерах. Этот MCP-сервер даёт агенту прямой доступ к актуальной версии.

Цель проекта по README: дать моделям и агентам надёжный и свежий источник документации по вебу, чтобы они не опирались на устаревшие данные.

Три инструмента

Из файла INSTRUCTIONS.md репозитория:

• search ищет по документации MDN и возвращает краткие описания подходящих статей. Агенту советуют переформулировать вопрос в ключевые слова вроде fetch или flexbox.
• get-doc отдаёт полную статью в формате Markdown: описание, примеры, спецификации.
• get-compat возвращает данные о поддержке возможности в браузерах: Chrome, Firefox, Safari, Edge, на компьютере и телефоне. Ключ для него агент берёт из результатов search или get-doc, угадывать его запрещено.

Получается удобная цепочка: найти, прочитать, проверить поддержку. Для вёрстки это особенно полезно.

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

Команда для Claude Code взята из README, ставить ничего не нужно:

claude mcp add --transport http mdn https://mcp.mdn.mozilla.net/

В Codex в README команды нет. Строка в карточке составлена по справке самого Codex (codex mcp add --help: параметр --url для HTTP-серверов), адрес сервера - из README Mozilla. На живом сервере из Codex мы её не прогоняли, поэтому при ошибке сверься со справкой Codex.

Проверка: после подключения спроси агента, как работает свойство CSS container-type и во всех ли основных браузерах оно поддерживается. Агент должен сделать поиск и показать ссылки на MDN.

Общая инструкция по подключению серверов к Claude Code - в статье про MCP.

Главное предупреждение

Сервер экспериментальный, и Mozilla прямо пишет про хранение запросов. Данные, по их словам, не привязываются к сведениям, которые идентифицируют пользователя. Но запрос формулирует модель, а она может включить в него то, что ты ей рассказал. Если в разговоре есть что-то личное или рабочее, не хочешь отправлять - не подключай этот сервер или отключи его на время такого разговора.

Остальное безобидно: сервер только читает общедоступный справочник.

Что по лицензии

Код сервера - под лицензией MPL-2.0, полный текст лежит в файле LICENSE репозитория. Если собираешься менять код сервера и распространять его, прочитай условия лицензии целиком.

Мы сверили описание с README и INSTRUCTIONS.md на 22 октября 2026 года. Сервер сам не запускали.

Похожая по смыслу карточка для другого фреймворка - документация Astro. А если нужна свежая документация по любой библиотеке, смотри Context7.