Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add ragmir -e RAGMIR_PROJECT_ROOT=<RAGMIR_PROJECT_ROOT> -- npx -y @jcode.labs/ragmir
Open on GitHub

What 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/ragmir

Replace <…> 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open