Darwin RAG MCP server
io.github.Brightdotdev/darwin-rag·v0.2.18·3 starsLocal-first RAG engine with MCP server for AI agent integration.
3 stars37 downloads/wk
Reviews
Write oneNobody has reviewed Darwin RAG yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Darwin RAG tools (11, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
create_storewrite actionCreate a new DarwinStore at the given path for isolating data.
file_statusGet detailed status for a single file across all pipeline stages.
get_logsQuery Darwin session logs (oldest first for LLM readability).
get_schemaGet schema information for structured files (JSON arrays, CSVs).
get_search_result_by_idLoad a saved search result by its filename.
get_search_resultsList all saved search results.
list_filesList all files tracked by a store with their pipeline status.
purge_artifactswrite actionDelete pipeline artifacts for specific files.
run_pipelinewrite actionRun ingestion/indexing pipeline stages.
search_darwinSearch the DARWIN knowledge base for relevant passages.
search_listsSearch structured data (JSON arrays, CSVs) by field values with hybrid text fallback.
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan176 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 17 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Darwin RAG compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 68% of 4,460 AI and agents servers
- Tools
- 11
- the typical AI and agents server has 6
- Tools that change things
- 27%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 3
- more than 75% of 2,711 AI and agents servers
- Downloads a week
- 37
- more than 28% of 1,538 AI and agents servers with a package
What its tools let an agent do: 8 read · 1 create · 1 delete · 1 run or deploy
Install Darwin RAG in Claude Code, Cursor or VS Code
claude mcp add darwin-rag -- uvx darwin-rag
What the publisher says
From the Darwin RAG repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.Brightdotdev/darwin-rag -->
Darwin RAG
A local-first RAG engine that ingests documents, indexes them with BM25 + dense embeddings, and exposes search via an MCP server for AI agent integration.
- Ingestion — PDF, Markdown, HTML, images (OCR), CSV, Excel, ODS, URLs
- Indexing — BM25 keyword + dense embedding hybrid index with configurable chunking strategies
- Search — Hybrid, semantic, or keyword retrieval with reranking, diversity rerank, and structural penalties
- Generation — LLM-backed answer synthesis via LiteLLM (OpenAI, Anthropic, Gemini, etc.)
- Observability — Structured logging with per-session history, queryable via MCP
- Isolation — Multiple independent stores for tenant/project separation
- Deployment — stdio (AI agent subprocess), SSE, or Streamable HTTP; Docker-ready
- Local-first — Everything runs locally, fully offline-capable after setup
Built by BrightDotDev.
Quick Start
1. Install
pip install darwin-rag2. Set up models
# Interactive — detects hardware, pick your models
darwin-admin setup interactive
# Or one-shot (embedding-only, no prompts)
darwin-admin setup --preset required3. Start the MCP server & connect
# stdio mode — for AI agent subprocess (Claude Desktop, Cursor, etc.)
darwin mcp
# Or HTTP mode — for remote clients
darwin mcp --http --port 8765Configure your MCP client:
{
"mcpServers": {
"darwin": {
"command": "darwin",
"args": ["mcp"],
"env": {
"OPENAI_API_KEY": "sk-..." // At least one LLM provider key
}
}
}
}Or generate config automatically:
darwin config claude # Claude Desktop config
darwin config cursor # Cursor config
darwin config all --copy # All clients + copy to clipboardMCP Tools
Full documentation: docs/mcp.md
Remote / HTTP Mode
Start the server on a network-accessible endpoint:
# SSE transport (legacy)
darwin mcp --sse --host 0.0.0.0 --port 8765
# Streamable HTTP transport (recommended for production)
darwin mcp --http --host 0.0.0.0 --port 8765Configure your MCP client with the URL:
{
"mcpServers": {
"darwin": {
"url": "http://your-host:8765/mcp" // or /sse for SSE mode
}
}
}Environment Variables
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Darwin RAG: common questions
- Is Darwin RAG MCP server safe?
- Mostly: it is graded B (83/100). Read the Darwin RAG safety report
- How do I install Darwin RAG?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Darwin RAG need an API key?
- Yes. The registry entry asks for
OPENAI_API_KEY,ANTHROPIC_API_KEY,GEMINI_API_KEY. - Is Darwin RAG maintained?
- The last commit was 21 days ago (2026-10-14). The latest release is v0.2.18.
- What can I use instead of Darwin RAG?
- Servers from other publishers that do the same job: Basic Memory MCP server, HOL Guard MCP server and Agent-Native Chat MCP server.
- How does Darwin RAG compare with other AI and agents MCP servers?
- safety score 83/100 (higher than 68% of 4,460 AI and agents servers); tools 11 (the typical AI and agents server has 6); tools that change things 27% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Darwin RAG
Same job from other publishers: the closest match first, then the best rated.
- Basic MemoryLocal-first knowledge management with bi-directional LLM sync via Markdown files.not reviewedWidely usedB
- HOL GuardLocal-first AI agent security evidence and approval workflows through HOL Guard's stdio MCP server.not reviewedEstablishedA
- Agent-Native ChatMinimal chat-first app with durable threads, actions, and the app-agent loopnot reviewedEstablishedA
Summer EngineThe game engine built for AI. Any agent makes a multiplayer game and publishes it.not reviewedEstablishedB- Local RagEasy-to-setup local RAG server with minimal configurationnot reviewedEstablishedA