trovex — MCP-сервер для Claude Code: одна актуальная дока вместо перечитывания репозитория
Индексирует markdown в репозитории и отдаёт агенту один актуальный документ по запросу, а не стопку кандидатов. Экономит токены на поиске по докам.
claude mcp add trovex -- uvx trovexЧто делает trovex
Агенты каждую сессию заново перечитывают репозиторий, чтобы понять, какой .md сейчас в силе, и отвечают по догадке. trovex строит по markdown один канонический индекс и поднимает MCP-сервер: на вопрос агент получает указатель path:line на единственный актуальный документ с пометкой свежести (canonical / stale / duplicate) и только тот раздел, который отвечает, а не весь файл.
Внутри шесть MCP-инструментов. Три только читают (trovex, trovex_read, trovex_search), три пишут лишь в собственное хранилище trovex (trovex_write, trovex_tag, trovex_delete). Оболочка не запускается, исходники не меняются. Векторы лежат в SQLite, эмбеддинги считает ONNX локально, поэтому ключ API и сеть для ответа на запрос не нужны. Замеры на своём репозитории дали около 60% экономии токенов при равном успехе задач; на вашем репозитории цифра будет другой, и trovex search печатает сэкономленное.
Ставится из PyPI через uv tool install trovex, дальше trovex setup прописывает скилл, хуки и MCP-сервер в Claude за один шаг. Если uv нет, его ставят отдельно. Сервер поднимается командой trovex serve и слушает http://localhost:8765/mcp, дашборд экономии — на http://localhost:8765/savings. Без запущенного trovex serve клиент к серверу не подключится.
Какие задачи решает
- найти единственный актуальный документ по вопросу агента
- перестать платить токенами за перечитывание репозитория каждую сессию
- отличить устаревший документ от действующего при похожести текстов
- отдавать агенту нужный раздел, а не весь файл целиком
- свести знания нескольких агентов и людей в одно хранилище
Примеры запросов агенту
- Как откатить деплой? Найди канонический документ через trovex.
- Проиндексируй markdown в репозитории и покажи, сколько токенов сэкономил поиск.
- Запиши через trovex_write рунбук по откату деплоя в общее хранилище.
Как установить trovex
Командой платформы
claude mcp add trovex -- uvx trovexuvx запускает команду с именем пакета; если в README она другая — uvx --from trovex <команда>
Командой платформы
codex mcp add trovex -- uvx trovexuvx запускает команду с именем пакета; если в README она другая — uvx --from trovex <команда>
Файл настроек
{
"mcpServers": {
"trovex": {
"command": "uvx",
"args": [
"trovex"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from trovex <команда>
Файл настроек
{
"servers": {
"trovex": {
"type": "stdio",
"command": "uvx",
"args": [
"trovex"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from trovex <команда>
Командой платформы
gemini mcp add trovex uvx trovexuvx запускает команду с именем пакета; если в README она другая — uvx --from trovex <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о trovex
Как установить trovex в Claude Code?
Сначала uv tool install trovex, затем trovex setup — команда прописывает скилл, хуки и MCP-сервер за один шаг. После этого перезапустите Claude, чтобы он подхватил скилл и хуки.
Что делает trovex?
Индексирует markdown репозитория и по запросу агента возвращает один актуальный документ с указателем path:line и пометкой свежести. Отдаёт только нужный раздел, а не весь файл.
Нужны ли ключи API или облако?
Нет. Векторы хранятся в SQLite, эмбеддинги считает ONNX, поиск идёт локально. Ключ нужен только для trovex bench --eval, где ответы оценивает LLM.
