# Vinv

Vinv связывает runtime-трассы с исходным кодом и проверяет правки агента повторным запуском. Даёт агенту доказательства того, как код ведёт себя при выполнении.

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

## Что делает

Vinv предоставляет 16 инструментов: семантический поиск по кодовой базе, поиск мёртвого кода, локализацию ошибок по трассам выполнения, извлечение runtime-значений и данных о покрытии. Строит контекст в папке `.vinv/` — граф кода, трассы, метрики, привязанные к функциям, которые обработали каждый запрос. Все агенты читают один и тот же `.vinv/`-стор.

Первая сборка требует uv и Rust, занимает около трёх минут и скачивает модель эмбеддингов размером примерно 100 МБ. Первая трасса появляется через минуту после сборки, дальше всё работает за секунды. Vinv работает полностью локально, телеметрия отсутствует.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `VINV_WORKSPACE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env VINV_WORKSPACE=<VINV_WORKSPACE> --transport stdio vinv -- npx -y vinv-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add vinv --env VINV_WORKSPACE=<VINV_WORKSPACE> -- npx -y vinv-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vinv": {
            "command": "npx",
            "args": [
                "-y",
                "vinv-mcp"
            ],
            "env": {
                "VINV_WORKSPACE": "<VINV_WORKSPACE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "vinv": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "vinv-mcp"
            ],
            "env": {
                "VINV_WORKSPACE": "<VINV_WORKSPACE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e VINV_WORKSPACE=<VINV_WORKSPACE> vinv npx -y vinv-mcp
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- Найди мёртвый код в текущем проекте
- Покажи runtime-значения для функции `process_request` из последнего запуска
- Проверь, какие функции вызывались при обработке этого запроса

## Похожие
- [fix-agent-issue](https://affpapa.org/nevibecode/skills/fix-agent-issue.md) — скилл · 376 установок
- [debugging](https://affpapa.org/nevibecode/skills/mrgoonie-debugging.md) — скилл · 580 установок
- [debug](https://affpapa.org/nevibecode/skills/yeachan-heo-debug.md) — скилл · 705 установок
- [debug-like-expert](https://affpapa.org/nevibecode/skills/debug-like-expert.md) — скилл · ★ 1988 у репозитория
- [langfuse](https://affpapa.org/nevibecode/plugins/aviv-sinai-langfuse.md) — плагин · ★ 1596 у репозитория
- [lightrun](https://affpapa.org/nevibecode/plugins/lightrun.md) — плагин · ★ 27 у репозитория

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