Vouch — MCP-сервер для Claude Code: что делает и как установить
Хранит память ИИ-агентов в репозитории и блокирует прямую запись без проверки человеком. Помогает избежать каши в заметках, когда с кодовой базой работают несколько моделей или разработчиков.
claude mcp add --env VOUCH_KB_PATH=<VOUCH_KB_PATH> --transport stdio vouch -- uvx vouch-kbЧто делает Vouch
Vouch превращает локальную базу знаний проекта в набор обычных файлов внутри каталога .vouch/. Агенты не могут напрямую переписывать память: они лишь предлагают новые факты, оформленные как утверждения в YAML. Окончательное подтверждение остаётся за человеком. Только после ручной проверки данные сохраняются в репозиторий и версионируются через Git.
Система проверяет каждую цитату перед публикацией страницы. Команда vouch compile собирает тематические статьи Markdown, опираясь исключительно на подтверждённые тезисы. Если утверждение не ссылается на источник с вычисленным хешем содержимого, валидация выдаст ошибку.
Для запуска через uvx потребуется Python-пакет vouch-kb, а для локального веб-интерфейса на порту 5173 доступна сборка vouch-kb[web]. Без явного подтверждения предложенных правок со стороны человека ни одна запись не попадёт в постоянную историю проекта.
Какие задачи решает
- сохранять контекст сессий ИИ-агентов в виде файлов репозитория
- блокировать несанкционированные изменения в базе знаний проекта
- проверять ссылки на источники перед компиляцией сводных страниц
- вести журнал изменений фактов при совместной работе нескольких агентов
Примеры запросов агенту
- Проверь предложенные утверждения в
.vouch/и покажи, что ожидает подтверждения - Собери через
vouch compileобзорную страницу по архитектуре на основе подтверждённых фактов - Зафиксируй новое решение по базе данных как черновик утверждения для базы знаний
Как установить Vouch
Командой платформы
claude mcp add --env VOUCH_KB_PATH=<VOUCH_KB_PATH> --transport stdio vouch -- uvx vouch-kbВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from vouch-kb <команда>
Командой платформы
codex mcp add vouch --env VOUCH_KB_PATH=<VOUCH_KB_PATH> -- uvx vouch-kbВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from vouch-kb <команда>
Файл настроек
{
"mcpServers": {
"vouch": {
"command": "uvx",
"args": [
"vouch-kb"
],
"env": {
"VOUCH_KB_PATH": "<VOUCH_KB_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from vouch-kb <команда>
Файл настроек
{
"servers": {
"vouch": {
"type": "stdio",
"command": "uvx",
"args": [
"vouch-kb"
],
"env": {
"VOUCH_KB_PATH": "<VOUCH_KB_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from vouch-kb <команда>
Командой платформы
gemini mcp add -e VOUCH_KB_PATH=<VOUCH_KB_PATH> vouch uvx vouch-kbВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from vouch-kb <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Vouch
Как установить Vouch в Claude Code?
Выполните команду claude mcp add vouch -- uvx vouch-kb. Если нужно задать конкретный путь к каталогу знаний, используйте вариант с переменной окружения: claude mcp add --env VOUCH_KB_PATH=<VOUCH_KB_PATH> --transport stdio vouch -- uvx vouch-kb.
Что делает Vouch?
Сервер создаёт Git-совместимую базу знаний, где модели предлагают изменения, но не могут вносить их напрямую. Каждая запись требует одобрения человеком и содержит проверяемые ссылки на источники.
Где сохраняются подтверждённые данные?
Все одобренные тезисы и документы лежат прямо в репозитории внутри каталога .vouch/. Благодаря этому база данных версионируется вместе с кодом и клонируется стандартной командой git clone.
