Paparats — MCP-сервер для Claude Code: локальный семантический поиск по коду
Ищет по смыслу сразу в нескольких репозиториях и держит память об архитектуре проекта. Пригодится, когда агент теряется в чужой кодовой базе.
claude mcp add paparats-mcp -- npx -y @paparats/cliЧто делает Paparats – Local Semantic Code Search MCP
Сервер индексирует репозитории и отвечает на запросы агента по смыслу, а не по строкам. Разбивка кода идёт с учётом синтаксиса через tree-sitter, поддерживается 11 языков. После индексации к фрагментам подтягиваются история git, ссылки на тикеты и связи между символами: вызовы, обратные вызовы, упоминания.
Поиск работает с префиксами задач (nl2code, code2code, techqa), расширяет запрос по сокращениям и падежам, кэширует результаты в памяти и считает уверенность попадания. Отдельный слой архитектурной памяти хранит карточки трёх видов — компоненты, решения и уроки — в коллекции Qdrant на группу. Агент сам их пополняет: похожие решения отклоняются, если косинусная близость выше 0.85, а уроки обновляют уже существующую карточку.
Эндпоинт /knowledge/mcp включается только при заданных PAPARATS_KNOWLEDGE_TOKENS и PAPARATS_KNOWLEDGE_AUDIENCE — если задать одно без другого, сервер не стартует. Ещё стоит выставить PAPARATS_KNOWLEDGE_PROJECTS: без него случайный audience: в README какого-нибудь репозитория расширит выдачу.
Какие задачи решает
- найти нужный участок кода по описанию задачи, а не по имени функции
- связать фрагменты кода с историей git и тикетами
- сохранить между сессиями, почему архитектура устроена именно так
- отдать внешнему сервису только документацию, без внутренних заметок
- проверить, не устарела ли карточка решения или урока
Примеры запросов агенту
- Найди в репозиториях, где обрабатывается авторизация через токен
- Инициализируй архитектурную память по этому репозиторию
- Запиши урок из моего исправления: не кэшировать ответы без заголовка
Cache-Control
Как установить Paparats – Local Semantic Code Search MCP
Командой платформы
claude mcp add paparats-mcp -- npx -y @paparats/cliКомандой платформы
codex mcp add server -- npx -y @paparats/cliФайл настроек
{
"mcpServers": {
"server": {
"command": "npx",
"args": [
"-y",
"@paparats/cli"
]
}
}
}Файл настроек
{
"servers": {
"server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paparats/cli"
]
}
}
}Командой платформы
gemini mcp add server npx -y @paparats/cliПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Paparats – Local Semantic Code Search MCP
Как установить Paparats в Claude Code?
Выполните claude mcp add paparats-mcp -- npx -y @paparats/cli. Сервер поднимется как MCP-сервер с именем paparats-mcp.
Что делает Paparats?
Индексирует несколько репозиториев и даёт агенту семантический поиск по коду. Дополнительно ведёт архитектурную память: компоненты, решения и уроки, которые агент пополняет сам.
Что нужно задать для режима knowledge?
Переменные PAPARATS_KNOWLEDGE_TOKENS и PAPARATS_KNOWLEDGE_AUDIENCE — обе сразу. Если задать только одну, сервер не запустится.
