# Ragmir

MCP-сервер Ragmir для Claude Code и Codex индексирует кодовую базу, спецификации и офисные файлы локально. Находит фрагменты с точными ссылками на строки кода, страницы PDF или ячейки таблиц.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 у репозитория
- Автор: jcode-works
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jcode-works/ragmir/tree/HEAD/packages/ragmir-core
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/ragmir

## Что делает

Ragmir строит гибридный индекс на базе BM25 и векторного поиска прямо на машине разработчика. Поисковый алгоритм разбирает идентификаторы в camelCase, учитывает пути файлов и поднимает в выдаче места с объявлением сущностей. Чат-модели внутри нет: сервер только отдаёт контекст подключённому агенту.

Вместо приблизительных ответов выдаются фрагменты с координатами первоисточника. Сервер помечает изменившиеся файлы и предупреждает о слабом совпадении доказательной базы с запросом.

Парсинг, эмбеддинги и поисковый индекс работают в одном процессе Node.js без сторонней телеметрии и передачи данных во внешние облака. Для запуска нужен Node.js версии не ниже 22.12 и переменная окружения `RAGMIR_PROJECT_ROOT`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `RAGMIR_PROJECT_ROOT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add ragmir -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmir
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add ragmir-core --env RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmir
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ragmir-core": {
            "command": "npx",
            "args": [
                "-y",
                "@jcode.labs/ragmir"
            ],
            "env": {
                "RAGMIR_PROJECT_ROOT": "<RAGMIR_PROJECT_ROOT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "ragmir-core": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@jcode.labs/ragmir"
            ],
            "env": {
                "RAGMIR_PROJECT_ROOT": "<RAGMIR_PROJECT_ROOT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> ragmir-core npx -y @jcode.labs/ragmir
```
Вместо <…> подставьте свои значения

## Когда брать
- найти точные места объявления функций по кодовой базе
- извлечь цитаты из PDF-файлов, таблиц и документов Word
- подключить офлайн-индекс репозитория к ассистенту кодинга
- отследить расхождения между кодом и документацией

## Примеры запросов агенту
- Найди в спецификациях требования к контракту аутентификации
- Покажи фрагменты кода, где объявляется валидация сессий
- Сверь шаги развёртывания из таблицы требований с исходным кодом

## Похожие
- [ai-data-engineering-rag-pipeline](https://affpapa.org/nevibecode/skills/ai-data-engineering-rag-pipeline.md) — скилл · 165 установок
- [embedding-pipeline-builder](https://affpapa.org/nevibecode/skills/embedding-pipeline-builder.md) — скилл · 259 установок
- [wiki-retrieve](https://affpapa.org/nevibecode/skills/wiki-retrieve.md) — скилл · 348 установок
- [Echo Memory](https://affpapa.org/nevibecode/mcp/echo-memory.md) — MCP-сервер · ★ 2 у репозитория
- [alcove](https://affpapa.org/nevibecode/plugins/alcove.md) — плагин · ★ 1596 у репозитория
- [Holographic Memory](https://affpapa.org/nevibecode/mcp/holographic-memory.md) — MCP-сервер · ★ 23 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
