Overview
What is MCP RAG?
MCP RAG is an AI-powered chat system built on the Model Context Protocol (MCP) client-server architecture. It connects to multiple specialized MCP servers—Filesystem, Slack, and Brave Search—to give Claude access to local files, Slack conversations, and real-time web search. This system is for users who want a single interface that automatically retrieves context from diverse sources without manual server selection.
How to use MCP RAG?
First, install uv (see README for commands). Then clone the repository, create a .env file with your ANTHROPIC_API_KEY, SLACK_BOT_TOKEN, SLACK_TEAM_ID, and BRAVE_API_KEY. Create a virtual environment and install dependencies using uv venv and uv sync. Finally, run the client with uv run client.py path/to/dir/you/want/to/use.
Key features of MCP RAG
- Integrates with local filesystem, Slack, and Brave Search servers.
- Automatically selects the right server based on user query.
- Powered by Claude AI (Anthropic API).
- Built on standard MCP client-server architecture.
- Open source under MIT License.
- Dependencies managed via
uv.
Use cases of MCP RAG
- Search and retrieve information from local folders via Filesystem server.
- Query Slack workspace history for conversations and shared resources.
- Perform real-time web searches to fetch latest information.
- Combine multiple data sources seamlessly without explicit instructions.
FAQ from MCP RAG
What dependencies are required to run MCP RAG?
The system requires uv for package and environment management, plus API keys for Anthropic, Slack, and Brave Search.
How do I configure the API keys?
Create a .env file in the project root and add ANTHROPIC_API_KEY, SLACK_BOT_TOKEN, SLACK_TEAM_ID, and BRAVE_API_KEY with your credentials.
What data sources does MCP RAG support?
MCP RAG uses three MCP servers: Filesystem (local folders), Slack (workspace conversations), and Brave Search (web). The system intelligently chooses which to query.
Is MCP RAG open source?
Yes, it is licensed under the MIT License, allowing free use, modification, and distribution.
How does MCP RAG decide which server to use?
Claude analyzes the question and automatically selects the appropriate MCP server (Filesystem, Slack, or Brave Search) without requiring explicit user instructions.
