Vinv — MCP-сервер для Claude Code: тестирование и проверка кода
Vinv связывает runtime-трассы с исходным кодом и проверяет правки агента повторным запуском. Даёт агенту доказательства того, как код ведёт себя при выполнении.
Apache-2.0 ★ 48 обновлён 2026-10-20
claude mcp add --env VINV_WORKSPACE=<VINV_WORKSPACE> --transport stdio vinv -- npx -y vinv-mcpЧто делает Vinv
Vinv предоставляет 16 инструментов: семантический поиск по кодовой базе, поиск мёртвого кода, локализацию ошибок по трассам выполнения, извлечение runtime-значений и данных о покрытии. Строит контекст в папке .vinv/ — граф кода, трассы, метрики, привязанные к функциям, которые обработали каждый запрос. Все агенты читают один и тот же .vinv/-стор.
Первая сборка требует uv и Rust, занимает около трёх минут и скачивает модель эмбеддингов размером примерно 100 МБ. Первая трасса появляется через минуту после сборки, дальше всё работает за секунды. Vinv работает полностью локально, телеметрия отсутствует.
Какие задачи решает
- проверить правку агента через повторный запуск кода
- найти баг по трассе выполнения сервиса
- связать runtime-поведение с конкретной функцией в исходнике
- отследить покрытие и значения переменных
- локализовать ошибку в работающем приложении
Примеры запросов агенту
- Найди мёртвый код в текущем проекте
- Покажи runtime-значения для функции
process_requestиз последнего запуска - Проверь, какие функции вызывались при обработке этого запроса
Как установить Vinv
Командой платформы
claude mcp add --env VINV_WORKSPACE=<VINV_WORKSPACE> --transport stdio vinv -- npx -y vinv-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add vinv --env VINV_WORKSPACE=<VINV_WORKSPACE> -- npx -y vinv-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"vinv": {
"command": "npx",
"args": [
"-y",
"vinv-mcp"
],
"env": {
"VINV_WORKSPACE": "<VINV_WORKSPACE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"vinv": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vinv-mcp"
],
"env": {
"VINV_WORKSPACE": "<VINV_WORKSPACE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e VINV_WORKSPACE=<VINV_WORKSPACE> vinv npx -y vinv-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Vinv
Как установить Vinv в Claude Code?
Выполни команду claude mcp add vinv -- npx -y vinv-mcp в терминале. Для указания конкретной рабочей директории добавь --env VINV_WORKSPACE=<путь> перед vinv.
Что делает Vinv?
Vinv собирает трассы выполнения, связывает их с исходным кодом и даёт агенту инструменты для поиска багов, проверки правок и анализа покрытия. Агент получает доказательства того, как код работает на самом деле.
Что нужно для первого запуска Vinv?
Установленные uv и Rust. Первая сборка занимает около трёх минут и скачивает модель эмбеддингов размером примерно 100 МБ. После этого всё работает за секунды.