Minirag MCP

A local-first RAG (retrieval-augmented generation) MCP server. Point it at a folder of documents and it gives your MCP client (Claude Code, Cursor, Codex, ...) hybrid search - semantic vector similarity plus a keyword boost for exact terms - over that content.

People connecting AI & ML tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-10 · ★ 2 · #41 OF 95 MAINTAINED AI & ML · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Minirag MCP

before you install - you'll need

Set BASE_DIR, RAG_INSTRUCTIONS_APPEND before connecting.

Claude Code

claude mcp add sfrangulov-minirag-mcp -- uvx minirag-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "sfrangulov-minirag-mcp": {
      "command": "uvx",
      "args": [
        "minirag-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-08-07 - young repo, little track record yet

license MIT - declared in the repository

pypi package minirag-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.sfrangulov is GitHub-verified and matches the repo owner

03 · What Minirag MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.6.0 · 2026-08-09

Follow-ups on the OCR tier from v0.5.0 - the bugs its own merge review filed. · Fixed · A sync from an install without the [ocr] extra deleted indexed images. The · scanner filters by the OCR-gated extension whitelist…

v0.5.0 · 2026-08-09

OCR for scanned documents · Scanned documents no longer disappear from the index. A scanned PDF used to · convert to an empty document and be counted as a sync failure; image files were · not in the extension whitelist…

v0.4.1 · 2026-08-09

Publishes minirag-mcp to the official MCP registry. · The registry verifies ownership of a PyPI package by finding an mcp-name: marker in the package description, and PyPI descriptions are immutable per version - so…

04 · Who maintains Minirag MCP

minirag-mcp is maintained by sfrangulov. It's the only MCP server we track from this author; the repo dates to Aug 2026.

05 · Facts

repository: github.com/sfrangulov/minirag-mcp
website: https://github.com/sfrangulov/minirag-mcp#readme
category: AI & ML - ranked #41 of 95 actively-maintained AI & ML servers as of 2026-08-25.
release cadence: 9 releases in the last 90 days (latest 2026-08-09)
registry: io.github.sfrangulov/minirag-mcp (active, first published 2026-08-09 · 3 versions)
packages: pypi:minirag-mcp

06 · Minirag MCP FAQ

What is Minirag MCP?

Is Minirag MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-10 and it shipped 9 releases in the last 90 days. We re-verify nightly.

How do I install Minirag MCP?

Run `uvx minirag-mcp`. The README documents 2 environment variables (BASE_DIR, RAG_INSTRUCTIONS_APPEND) to set first. Set BASE_DIR, RAG_INSTRUCTIONS_APPEND before connecting. You can also paste the ready-made client config above.

Does Minirag MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Minirag MCP

Alternatives to Minirag MCP

Maintained AI & ML servers if Minirag MCP isn't the fit.

Pairs well with

Servers that cover what Minirag MCP doesn't - only shown when the pairing reason fits the companion.

More AI & ML MCP servers · Oasyce · Local RAG (shinpr) · Quesen Deterministic Agent Decision Layer · Sidclaw Governance MCP · Notepatra MCP

More Python MCP servers · Dev Time · Shuck File · Xiaohongshu (Little Red Book) MCP Server · Pykrx MCP · see all