contextatlas — MCP-сервер для Claude Code: контекст кода одним вызовом
Собирает структуру кода, решения из ADR, историю git и тесты в один контекстный пакет. Меньше токенов на поиск по репозиторию.
claude mcp add contextatlas -- npx -y contextatlasЧто делает contextatlas
ContextAtlas — MCP-сервер, который отдаёт агенту готовый срез по символу за один вызов. Внутри четыре сигнала: данные языкового сервера (определение, ссылки, типы, диагностика), архитектурные решения из ADR и документации, история git с пометками горячих и холодных мест, а также привязка к тестам. Всё это склеивается в один ответ вместо череды grep и чтения файлов.
Работает и без ADR в репозитории: тогда приходят структура, git и тесты. Чем больше сигналов, тем плотнее пакет. Экономия токенов растёт с размером кодовой базы, а вот захват архитектурных решений от размера не зависит — в библиотеке на 30 файлов тоже бывают ограничения, которые агенту стоит знать до правки.
Ставится через npx, отдельный сервер поднимать не нужно. Для Cursor и GitHub Copilot конфигурация прописывается вручную в файле настроек MCP. Если в проекте нет ADR, часть ценности теряется — это повод завести хотя бы пару записей о ключевых решениях.
Какие задачи решает
- получить контекст по символу одним вызовом вместо серии grep
- увидеть архитектурные ограничения до того, как агент предложит правку
- найти тесты, которые ссылаются на конкретный класс или функцию
- оценить, насколько часто символ менялся в последних коммитах
- сократить расход токенов на разбор незнакомого репозитория
Примеры запросов агенту
- Дай контекст по
OrderProcessorперед тем, как что-то менять - Какие ADR касаются модуля оплаты?
- Покажи, какие тесты покрывают
charges.ts
Как установить contextatlas
Командой платформы
claude mcp add contextatlas -- npx -y contextatlasКомандой платформы
codex mcp add contextatlas -- npx -y contextatlasФайл настроек
{
"mcpServers": {
"contextatlas": {
"command": "npx",
"args": [
"-y",
"contextatlas"
]
}
}
}Файл настроек
{
"servers": {
"contextatlas": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"contextatlas"
]
}
}
}Командой платформы
gemini mcp add contextatlas npx -y contextatlasПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о contextatlas
Как установить contextatlas в Claude Code?
Одной командой: claude mcp add contextatlas -- npx -y contextatlas. После этого сервер доступен агенту в текущем проекте.
Что делает contextatlas?
Отдаёт агенту единый пакет контекста по символу: структуру от языкового сервера, выдержки из ADR, историю git и связанные тесты. Вместо десятка отдельных обращений к файлам.
Нужны ли ADR в репозитории?
Нет. Без них сервер всё равно возвращает структуру, git и тесты. С ADR пакеты становятся содержательнее, потому что к символам привязываются архитектурные решения.
