Install
$ agentstack add mcp-bluewings1211-codebase-rag ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
Codebase RAG MCP Server
A Retrieval-Augmented Generation (RAG) Model-Controller-Provider (MCP) server designed to assist AI agents and developers in understanding and navigating codebases.
Quick Links
- [Getting Started](GETTING_STARTED.md): Installation and Basic Usage.
- [User Manual](MANUAL.md): Tutorials, Features, and Advanced Usage.
- [Configuration](docs/CONFIGURATION.md): Environment variables and performance tuning.
- [Architecture](ARCHITECTURE.md): System design and high-level overview.
- [Contributing](CONTRIBUTING.md): Developer setup and guidelines.
Overview
This tool allows you to "chat" with your code. It indexes your local directories or GitHub repositories into a vector database (Qdrant), allowing Large Language Models to perform semantic searches and retrieve accurate code snippets.
Key Features
- 🔍 Semantic Search: Find code by meaning, not just keywords.
- 🎯 Two-Stage RAG: 22-31% accuracy improvement with cross-encoder reranking (Qwen3-Reranker).
- 🧠 Intelligent Chunking: Parses code into functions and classes using Tree-sitter for better context.
- ⚡ High Performance: Supports incremental indexing and MPS acceleration on macOS.
- 🌐 Multi-Language: Supports Python, JavaScript, TypeScript, Go, Rust, Java, C++, and more.
- 📝 File Logging: Optional centralized logging with automatic rotation for debugging.
Quick Start
- Setup:
``bash ./setup.sh ``
- Index Code:
``bash uv run python manual_indexing.py -d "." -m clear_existing ``
- Connect:
Follow the instructions from setup.sh to add the server to your MCP client (e.g., Claude Desktop).
For detailed instructions, please visit [Getting Started](GETTING_STARTED.md).
Documentation
Detailed documentation is available in the docs/ directory:
- [MCP Tools Reference](docs/MCP_TOOLS.md)
- [Architecture Deep Dive](docs/ARCHITECTUREDEEPDIVE.md)
License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: bluewings1211
- Source: bluewings1211/codebase-RAG
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.