modular-rag-mcp-server — Claude Code skill for RAG setup
This skill guides the deployment and configuration of a modular RAG system exposed to assistants through MCP. Use it when connecting an assistant to a document knowledge base.
no license 199 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill modular-rag-mcp-server -a claude-codeWhat modular-rag-mcp-server does
The skill covers a RAG workflow for adding documents to a knowledge base, retrieving results with semantic and exact-match search, and connecting the system to an assistant over MCP. The server provides tools to query the hub, list collections, and get a document summary. The project also includes a Streamlit dashboard and Ragas-based evaluation.
Models, embedding providers, rerankers, text splitters, and vector stores can be selected through configuration. Deployment requires Python 3.9+ and API keys for the providers you choose, such as OpenAI, Anthropic, or Cohere. A missing key for a selected provider will prevent that integration from working.
Install the skill with npx skills add reason-machines/mcp-skills --skill modular-rag-mcp-server -a claude-code. It provides setup guidance; building the RAG project itself involves creating a virtual environment, installing dependencies, and configuring .env.
What it helps with
- connect an MCP server to an assistant
- ingest a PDF into a knowledge base
- retrieve documents with hybrid search
- configure an embedding provider or reranker
- evaluate RAG results with Ragas
Example prompts for the agent
- Help me configure the modular RAG system and connect it to Claude Code through MCP.
- Explain how to ingest a PDF into the knowledge base and search its contents.
- Show me how to choose an embedding provider and evaluate retrieval with Ragas.
How to install modular-rag-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill modular-rag-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/modular-rag-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/modular-rag-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill modular-rag-mcp-server -a codex2Manually: put the files in place
.agents/skills/modular-rag-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill modular-rag-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/modular-rag-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/modular-rag-mcp-server2Manually: put the files in place
.github/skills/modular-rag-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill modular-rag-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/modular-rag-mcp-serverManually: put the files in place
.devin/skills/modular-rag-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill modular-rag-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about modular-rag-mcp-server
How do I install modular-rag-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill modular-rag-mcp-server -a claude-code. The skill file is at ~/.claude/skills/modular-rag-mcp-server/SKILL.md.
What does modular-rag-mcp-server do?
It guides setup of a modular RAG system with hybrid retrieval and MCP tools for querying a knowledge base. It also covers the dashboard and Ragas evaluation.
What do I need to configure the RAG system?
You need Python 3.9+ and API keys for the providers you select. The required keys depend on the model, embedding, and other component settings.