fixmap — MCP-сервер для Claude Code: что делает и как установить
Локально строит карту релевантных файлов и тестов по описанию задачи или диффу. Помогает направить контекст ИИ-агента без вызовов внешних API.
claude mcp add fixmap -- npx -y @aryam/fixmapЧто делает fixmap
Сервер анализирует репозиторий на основе текста задачи, ссылки на issue GitHub или готового диффа. Вместо отправки кода во внешние нейросети утилита строит список файлов для правок, находит связанные тесты и зависимости. В отчёт попадают причины ранжирования и пометки о неуверенности.
Инструмент учитывает импорты, зависимости в коде и историю совместных коммитов в Git. Для экономии контекста можно ограничить выгрузку фрагментов токеновым бюджетом или экспортировать связи в формате Mermaid. Кэш репозитория хранится семь дней.
Для запуска нужен Node.js 20.11 или новее. Поскольку проект сканирует кодовую базу локально, сетевой доступ и API-ключи для построения карты не понадобятся.
Какие задачи решает
- отобрать приоритетные файлы для исправления бага по описанию задачи
- найти связанные тесты перед отправкой правок агенту
- проверить готовый Git-дифф на соответствие исходному плану
- построить граф зависимостей и затронутых компонентов в формате Mermaid
Примеры запросов агенту
- Составь список файлов и тестов для задачи из https://github.com/chalk/chalk/issues/624 через fixmap
- Собери контекст по ошибке отправки почты с лимитом в 10000 токенов
- Проверь текущий diff против сохранённого плана в plan.json
Как установить fixmap
Командой платформы
claude mcp add fixmap -- npx -y @aryam/fixmapКомандой платформы
codex mcp add fixmap -- npx -y @aryam/fixmapФайл настроек
{
"mcpServers": {
"fixmap": {
"command": "npx",
"args": [
"-y",
"@aryam/fixmap"
]
}
}
}Файл настроек
{
"servers": {
"fixmap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@aryam/fixmap"
]
}
}
}Командой платформы
gemini mcp add fixmap npx -y @aryam/fixmapПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fixmap
Как установить fixmap в Claude Code?
Выполните команду claude mcp add fixmap -- npx -y @aryam/fixmap в терминале. Для работы потребуется среда Node.js версии 20.11 или новее.
Что делает fixmap?
Он сканирует кодовую базу и определяет, какие модули, импорты и тесты относятся к описанной проблеме. Данные передаются ассистенту в компактном виде, исключая передачу исходников во внешние сервисы.
Требуются ли для работы сервера ключи API?
Внешние ключи или аккаунты нейросетей не нужны. Сервер работает локально на машине разработчика и строит граф связей без сторонних языковых моделей.
