CodeCartographer — MCP-сервер для Claude Code: разбор чужого кода
Превращает незнакомый репозиторий в слоистую архитектуру, поведенческие контракты и спецификацию для переписывания. Каждая фаза проверяется до запуска следующей.
claude mcp add codecartographer -- npx -y codecartographer-piЧто делает CodeCartographer
Сервер ведёт агента по конвейеру: архитектура, поиск дефектов, поведенческие контракты, протоколы, портирование, спецификация для переписывания. Результат каждой фазы ложится файлом в .codecarto/findings/, а не остаётся в переписке. Новая сессия или сжатие контекста подхватывают работу из status.yaml.
Перед переходом дальше стоит проверка. Фаза сама заполняет таблицу ## Validation, помечая критерии как PASS, PARTIAL или FAIL с обоснованием, а механическая часть сверяет связку доказательств с действиями и заявленные дополнительные результаты. На FAIL, пропавшем файле или нечитаемом вердикте конвейер останавливается. Модель судит себя честно, но два машинных контроля её подстраховывают.
На выходе reimplementation-spec.md — без привязки к языку, с перечнем модулей, сценариями приёмки и списком открытых вопросов. Его можно отдать другому агенту для сборки заново. Для работы нужен Node.js 20 или новее, а запуск идёт через npx.
Какие задачи решает
- разобрать незнакомый репозиторий по слоям
- найти дефекты до того, как на них наткнётся пользователь
- вытащить поведенческие контракты из кода сервера
- подготовить спецификацию для переписывания на другом языке
- не потерять прогресс анализа при сжатии контекста
Примеры запросов агенту
- Прогони конвейер CodeCartographer по этому репозиторию и покажи архитектуру
- Запусти фазу поиска дефектов и запиши находки в
.codecarto/findings/ - Собери
reimplementation-spec.mdпо завершённым фазам
Как установить CodeCartographer
Командой платформы
claude mcp add codecartographer -- npx -y codecartographer-piКомандой платформы
codex mcp add codecartographer -- npx -y codecartographer-piФайл настроек
{
"mcpServers": {
"codecartographer": {
"command": "npx",
"args": [
"-y",
"codecartographer-pi"
]
}
}
}Файл настроек
{
"servers": {
"codecartographer": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codecartographer-pi"
]
}
}
}Командой платформы
gemini mcp add codecartographer npx -y codecartographer-piПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о CodeCartographer
Как установить CodeCartographer в Claude Code?
Одна команда: claude mcp add codecartographer -- npx -y codecartographer-pi. После этого сервер доступен агенту как MCP.
Что делает CodeCartographer?
Прогоняет репозиторий через фазы анализа и складывает результаты в .codecarto/. В конце получается спецификация, по которой код можно собрать заново.
Что нужно для запуска?
Node.js версии 20 или выше: пакет запускается через npx. Для интерактивной работы авторы советуют расширение Pi, а MCP-сервер нужен агентам вроде Claude, Codex или Cursor.
