# Ragmir

Ragmir — an MCP server for Claude Code and Codex indexing local source code, specs, and office files. Delivers verified passages with line, page, or cell citations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: jcode-works
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jcode-works/ragmir/tree/HEAD/packages/ragmir-core
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ragmir

## What it does

Ragmir runs a combined BM25 and vector search engine locally on your machine. It parses file paths, handles camelCase identifiers, and prioritizes code definitions matching your query. The tool does not include an LLM; it supplies matched text to your chosen coding agent.

Search results come with exact anchors like line numbers, PDF pages, or spreadsheet cells. The system flags modified files and marks weak evidence whenever sources lack clear answers.

All parsing, embedding generation, and indexing execute within a single Node.js runtime without network calls or telemetry. Running it requires Node.js 22.12 or newer and the `RAGMIR_PROJECT_ROOT` environment variable.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `RAGMIR_PROJECT_ROOT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ragmir -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmir
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add ragmir-core --env RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmir
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ragmir-core": {
            "command": "npx",
            "args": [
                "-y",
                "@jcode.labs/ragmir"
            ],
            "env": {
                "RAGMIR_PROJECT_ROOT": "<RAGMIR_PROJECT_ROOT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ragmir-core": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@jcode.labs/ragmir"
            ],
            "env": {
                "RAGMIR_PROJECT_ROOT": "<RAGMIR_PROJECT_ROOT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> ragmir-core npx -y @jcode.labs/ragmir
```
Replace <…> with your own values

## When to use it
- search repositories and specs using hybrid text and vector retrieval
- pull verifiable excerpts from PDFs, presentations, and spreadsheets
- provide local context with source lines to coding assistants
- spot outdated documentation against current repository code

## Example prompts
- Locate the authentication contract specifications in the docs
- Find code snippets defining session validation logic
- Extract verification steps from spreadsheet test plans

## Similar
- [ai-data-engineering-rag-pipeline](https://affpapa.org/en/nevibecode/skills/ai-data-engineering-rag-pipeline.md) — skill · 165 installs
- [embedding-pipeline-builder](https://affpapa.org/en/nevibecode/skills/embedding-pipeline-builder.md) — skill · 259 installs
- [wiki-retrieve](https://affpapa.org/en/nevibecode/skills/wiki-retrieve.md) — skill · 348 installs
- [Echo Memory](https://affpapa.org/en/nevibecode/mcp/echo-memory.md) — MCP server · ★ 2 repo stars
- [alcove](https://affpapa.org/en/nevibecode/plugins/alcove.md) — plugin · ★ 1596 repo stars
- [Holographic Memory](https://affpapa.org/en/nevibecode/mcp/holographic-memory.md) — MCP server · ★ 23 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
