Ragmir — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер Ragmir для Claude Code и Codex индексирует кодовую базу, спецификации и офисные файлы локально. Находит фрагменты с точными ссылками на строки кода, страницы PDF или ячейки таблиц.
AGPL-3.0 ★ 6 обновлён 2026-11-16
claude mcp add ragmir -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmirЧто делает Ragmir
Ragmir строит гибридный индекс на базе BM25 и векторного поиска прямо на машине разработчика. Поисковый алгоритм разбирает идентификаторы в camelCase, учитывает пути файлов и поднимает в выдаче места с объявлением сущностей. Чат-модели внутри нет: сервер только отдаёт контекст подключённому агенту.
Вместо приблизительных ответов выдаются фрагменты с координатами первоисточника. Сервер помечает изменившиеся файлы и предупреждает о слабом совпадении доказательной базы с запросом.
Парсинг, эмбеддинги и поисковый индекс работают в одном процессе Node.js без сторонней телеметрии и передачи данных во внешние облака. Для запуска нужен Node.js версии не ниже 22.12 и переменная окружения RAGMIR_PROJECT_ROOT.
Какие задачи решает
- найти точные места объявления функций по кодовой базе
- извлечь цитаты из PDF-файлов, таблиц и документов Word
- подключить офлайн-индекс репозитория к ассистенту кодинга
- отследить расхождения между кодом и документацией
Примеры запросов агенту
- Найди в спецификациях требования к контракту аутентификации
- Покажи фрагменты кода, где объявляется валидация сессий
- Сверь шаги развёртывания из таблицы требований с исходным кодом
Как установить Ragmir
Командой платформы
claude mcp add ragmir -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmirВместо <…> подставьте свои значения
Командой платформы
codex mcp add ragmir-core --env RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmirВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"ragmir-core": {
"command": "npx",
"args": [
"-y",
"@jcode.labs/ragmir"
],
"env": {
"RAGMIR_PROJECT_ROOT": "<RAGMIR_PROJECT_ROOT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"ragmir-core": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@jcode.labs/ragmir"
],
"env": {
"RAGMIR_PROJECT_ROOT": "<RAGMIR_PROJECT_ROOT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> ragmir-core npx -y @jcode.labs/ragmirВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Ragmir
Как установить Ragmir в Claude Code?
Выполните команду claude mcp add ragmir -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmir. Вместо <RAGMIR_PROJECT_ROOT> укажите путь к корню проекта.
Что делает Ragmir?
Сервер выполняет гибридный поиск по исходному коду, офисным документам и PDF-файлам. Результаты возвращаются с номерами строк, страниц или ячеек без отправки файлов во внешние облака.
Что нужно для работы Ragmir?
Требуется Node.js 22.12 или новее. Также необходимо передать переменную окружения RAGMIR_PROJECT_ROOT с путём к целевому проекту.