# readfirst

MCP-сервер readfirst для Claude Code показывает правила проекта, риски и проверки перед изменением файла. Он связывает файлы, которые меняются вместе, и подсказывает тесты.

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

## Что делает

readfirst передаёт агенту сведения о файле перед его изменением: правила проекта, риски, проверки, тесты и связанные файлы. Данные хранятся в `.readfirst/map.json`; команда `npx readfirst init --agent --ci` создаёт начальную карту и настраивает подключение агентов и PR Action.

Команда `npx readfirst audit` ищет прошлые сбои в истории Git, а `npx readfirst scan` проверяет код на опубликованные типы ошибок. Для работы нужен Node 20 или новее. Сервер читает Git checkout и карту, без аккаунта и вызовов модели.

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

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

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

## Примеры запросов агенту
- Перед изменением `src/imports.mjs` покажи правила проекта, риски, тесты и связанные файлы.
- Проверь историю Git на прошлые сбои.
- Просканируй код на известные типы ошибок.

## Похожие
- [Context7](https://affpapa.org/nevibecode/mcp/context7.md) — MCP-сервер · 5563 установки
- [Search Google Flights](https://affpapa.org/nevibecode/mcp/search-google-flights.md) — MCP-сервер · 2595 установок
- [Math-MCP](https://affpapa.org/nevibecode/mcp/math-mcp.md) — MCP-сервер · 5958 установок
- [pipeworx gateway](https://affpapa.org/nevibecode/mcp/pipeworx-gateway.md) — MCP-сервер · 419019 установок
- [SparkForge](https://affpapa.org/nevibecode/mcp/sparkforge.md) — MCP-сервер · 219896 установок
- [OpenWebSearch](https://affpapa.org/nevibecode/mcp/openwebsearch.md) — MCP-сервер · 494 установки

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