# fixmap

Локально строит карту релевантных файлов и тестов по описанию задачи или диффу. Помогает направить контекст ИИ-агента без вызовов внешних API.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21
- Автор: aryamthecodebreaker
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/aryamthecodebreaker/FixMap
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/mcp/fixmap

## Что делает

Сервер анализирует репозиторий на основе текста задачи, ссылки на issue GitHub или готового диффа. Вместо отправки кода во внешние нейросети утилита строит список файлов для правок, находит связанные тесты и зависимости. В отчёт попадают причины ранжирования и пометки о неуверенности.

Инструмент учитывает импорты, зависимости в коде и историю совместных коммитов в Git. Для экономии контекста можно ограничить выгрузку фрагментов токеновым бюджетом или экспортировать связи в формате Mermaid. Кэш репозитория хранится семь дней.

Для запуска нужен Node.js 20.11 или новее. Поскольку проект сканирует кодовую базу локально, сетевой доступ и API-ключи для построения карты не понадобятся.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add fixmap -- npx -y @aryam/fixmap
```

### Codex

**Командой платформы**
```bash
codex mcp add fixmap -- npx -y @aryam/fixmap
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fixmap": {
            "command": "npx",
            "args": [
                "-y",
                "@aryam/fixmap"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "fixmap": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@aryam/fixmap"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add fixmap npx -y @aryam/fixmap
```

## Когда брать
- отобрать приоритетные файлы для исправления бага по описанию задачи
- найти связанные тесты перед отправкой правок агенту
- проверить готовый Git-дифф на соответствие исходному плану
- построить граф зависимостей и затронутых компонентов в формате Mermaid

## Примеры запросов агенту
- Составь список файлов и тестов для задачи из https://github.com/chalk/chalk/issues/624 через fixmap
- Собери контекст по ошибке отправки почты с лимитом в 10000 токенов
- Проверь текущий diff против сохранённого плана в plan.json

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md