Ragmir — Claude Code MCP server: what it does, how to install
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.
AGPL-3.0 ★ 6 updated 2026-11-16
claude mcp add ragmir -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmirWhat Ragmir 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.
What it helps with
- 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 for the agent
- Locate the authentication contract specifications in the docs
- Find code snippets defining session validation logic
- Extract verification steps from spreadsheet test plans
How to install Ragmir
Platform CLI
claude mcp add ragmir -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmirReplace <…> with your own values
Platform CLI
codex mcp add ragmir-core --env RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmirReplace <…> with your own values
Config file
{
"mcpServers": {
"ragmir-core": {
"command": "npx",
"args": [
"-y",
"@jcode.labs/ragmir"
],
"env": {
"RAGMIR_PROJECT_ROOT": "<RAGMIR_PROJECT_ROOT>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"ragmir-core": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@jcode.labs/ragmir"
],
"env": {
"RAGMIR_PROJECT_ROOT": "<RAGMIR_PROJECT_ROOT>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> ragmir-core npx -y @jcode.labs/ragmirReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Ragmir
How to install Ragmir in Claude Code?
Run claude mcp add ragmir -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmir. Replace <RAGMIR_PROJECT_ROOT> with the path to your repository root.
What does Ragmir do?
It searches through codebase files, PDFs, and office documents locally. Results include line coordinates and source indicators for your agent.
What is required to run Ragmir?
It requires Node.js version 22.12 or later. You must also set the RAGMIR_PROJECT_ROOT environment variable pointing to the target folder.