The privacy-first MCP server that transforms any repository into an AI-ready codebase with semantic search and RAG.
RagCode is a Model Context Protocol (MCP) server that instantly makes your project AI-ready. It enables AI assistants like GitHub Copilot, Cursor, Windsurf, and Claude to understand your entire codebase through semantic vector search, bridging the gap between your code and Large Language Models (LLMs).
Built with the official Model Context Protocol Go SDK, RagCode provides 9 powerful tools to index, search, and analyze code, making it the ultimate solution for AI-ready software development.
No Go, no build tools, no configuration needed. Just Docker.
| Linux (amd64) |
curl -fsSL https://github.com/doITmagic/rag-code-mcp/releases/latest/download/rag-code-mcp_linux_amd64.tar.gz | tar xz && ./ragcode-installer -ollama=docker -qdrant=docker |
| macOS (Apple Silicon) |
curl -fsSL https://github.com/doITmagic/rag-code-mcp/releases/latest/download/rag-code-mcp_darwin_arm64.tar.gz | tar xz && ./ragcode-installer -ollama=docker -qdrant=docker |
| macOS (Intel) |
curl -fsSL https://github.com/doITmagic/rag-code-mcp/releases/latest/download/rag-code-mcp_darwin_amd64.tar.gz | tar xz && ./ragcode-installer -ollama=docker -qdrant=docker |
| Windows (PowerShell) |
Invoke-WebRequest -Uri "https://github.com/doITmagic/rag-code-mcp/releases/latest/download/rag-code-mcp_windows_amd64.zip" -OutFile "ragcode.zip"; Expand-Archive ragcode.zip -DestinationPath . -Force; .\ragcode-installer.exe -ollama=docker -qdrant=docker |
That's it! The installer automatically:
- ✅ Downloads and installs the
rag-code-mcpbinary - ✅ Sets up Ollama and Qdrant in Docker containers
- ✅ Downloads required AI models (
phi3:medium,nomic-embed-text) - ✅ Configures your IDE (VS Code, Cursor, Windsurf, Claude Desktop)
- ✅ Adds binaries to your PATH
📖 Full Installation Guide → | Windows WSL Setup →
Once installed, you don't need to configure anything:
- Open your project in your IDE (VS Code, Cursor, Windsurf)
- Ask your AI assistant a question about your code
- That's it! RagCode automatically indexes and answers
💬 "How does the authentication system work?"
💬 "Find all API endpoints in this codebase"
💬 "Show me the User model and its relationships"
First query triggers background indexing. Subsequent queries are instant.
| Section | Description |
|---|---|
| 🔒 Privacy & Security | 100% local, zero cloud dependencies |
| 🚀 Why RagCode? | Performance benefits, comparisons |
| 🛠️ MCP Tools | All 9 tools explained |
| 🌐 Supported Languages | Go, PHP, Python support |
| 💻 IDE Integration | Windsurf, Cursor, VS Code, Claude |
| ⚙️ Configuration | Advanced settings, models, env vars |
| 🐛 Troubleshooting | Common issues and solutions |
| 📚 Documentation | All guides and references |
Your code never leaves your machine. RagCode runs entirely on your local infrastructure:
- ✅ Local AI Models - Uses Ollama for LLM and embeddings (runs on your hardware)
- ✅ Local Vector Database - Qdrant runs in Docker on your machine
- ✅ Zero Cloud Dependencies - No external API calls, no data transmission
- ✅ No API Costs - Free forever, no usage limits or subscriptions
- ✅ Offline Capable - Works without internet (after initial model download)
Perfect for: Enterprise codebases, proprietary projects, security-conscious teams.
| Task | Without RagCode | With RagCode | Speedup |
|---|---|---|---|
| Find authentication logic | 30-60s (read 10+ files) | 2-3s (semantic search) | 10-20x |
| Understand function signature | 15-30s (grep + read) | 1-2s (direct lookup) | 15x |
| Find all API endpoints | 60-120s (manual search) | 3-5s (hybrid search) | 20-40x |
- Without RagCode: AI reads 5-10 files (~15,000 tokens) to find a function
- With RagCode: AI gets exact function + context (~200 tokens)
| Feature | RagCode (Local) | Cloud AI Search |
|---|---|---|
| Privacy | ✅ 100% local | ❌ Code sent to cloud |
| Cost | ✅ $0 forever | ❌ $20-100+/month |
| Offline | ✅ Works offline | ❌ Requires internet |
| Data Control | ✅ You own everything | ❌ Vendor controls data |
| Aspect | Generic RAG | RagCode |
|---|---|---|
| Chunking | Arbitrary text splits | Semantic units (functions, classes) |
| Metadata | Filename only | Name, type, params, dependencies, lines |
| Results | May return partial code | Always complete, runnable code |
| Tool | Description | Use When |
|---|---|---|
search_code |
Semantic search by meaning | First choice for exploration |
hybrid_search |
Keyword + semantic for exact matches | Need exact identifiers |
get_function_details |
Complete function source code | Know exact function name |
find_type_definition |
Type/class with fields and methods | Understand data models |
find_implementations |
All usages and callers | Before refactoring |
list_package_exports |
All exported symbols | Explore unfamiliar packages |
search_docs |
Search Markdown documentation | Setup, architecture info |
get_code_context |
Code snippet with context | Have file:line reference |
index_workspace |
Reindex codebase | After major changes |
| Language | Support Level | Features | Docs |
|---|---|---|---|
| Go | ✅ Full | Functions, types, interfaces, methods, AST analysis | 📖 Go Analyzer |
| PHP | ✅ Full | Classes, methods, interfaces, traits, PHPDoc | 📖 PHP Analyzer |
| PHP + Laravel | ✅ Full | Eloquent models, routes, controllers, middleware | 📖 Laravel Analyzer |
| Python | ✅ Full | Classes, functions, decorators, type hints, mixins | 📖 Python Analyzer |
| JavaScript/TypeScript | 🔜 Planned | Coming soon (tree-sitter based) | - |
RagCode automatically detects and manages multiple workspaces with isolated indexes.
📖 Workspace Detection → - Auto-detection, stable IDs, caching
RagCode works with all major AI-powered IDEs:
| IDE | Status | Setup |
|---|---|---|
| Windsurf | ✅ Auto-configured | Just install |
| Cursor | ✅ Auto-configured | Just install |
| VS Code + Copilot | ✅ Auto-configured | Requires VS Code 1.95+ |
| Claude Desktop | ✅ Auto-configured | Just install |
| Antigravity | ✅ Auto-configured | Just install |
📖 Manual IDE Setup → | VS Code + Copilot Guide →
| Component | Requirement | Notes |
|---|---|---|
| CPU | 4 cores | For running Ollama models |
| RAM | 16 GB | 8 GB for phi3:medium, 4 GB for nomic-embed-text, 4 GB system |
| Disk | 10 GB free | ~8 GB for models + 2 GB for data |
| OS | Linux, macOS, Windows | Docker required for Qdrant |
| Component | Requirement | Notes |
|---|---|---|
| CPU | 8+ cores | Better concurrent operations |
| RAM | 32 GB | Comfortable multi-workspace indexing |
| GPU | NVIDIA 8GB+ VRAM | Significantly speeds up Ollama (optional) |
| Disk | 20 GB SSD | Faster indexing and search |
- Quick Start Guide - Install in 5 minutes
- IDE Setup - Manual IDE configuration
- Configuration Guide - Models, env vars, advanced settings
- Troubleshooting - Common issues and solutions
- Docker Setup - Docker configuration details
- Go Analyzer - Functions, types, interfaces, GoDoc
- PHP Analyzer - Classes, traits, PHPDoc
- Laravel Analyzer - Eloquent, routes, controllers
- Python Analyzer - Classes, decorators, type hints
- Architecture Overview - Technical deep dive
- Tool Schema Reference - Complete API documentation
- Incremental Indexing - How smart indexing works
- Workspace Detection - Multi-workspace support
- VS Code + Copilot - Detailed Copilot setup
- Model Context Protocol - Official MCP specification
- Ollama - Local LLM and embedding models
- Qdrant - Vector database
We welcome contributions! Here's how you can help:
- 🐛 Report Bugs
- 💡 Request Features - Share ideas for new tools or languages
- 🔧 Submit PRs - Improve code, docs, or add features
- ⭐ Star the Project - Show your support
git clone https://github.com/doITmagic/rag-code-mcp.git
cd rag-code-mcp
go mod download
go run ./cmd/rag-code-mcpRagCode MCP is open source software licensed under the MIT License.
semantic-code-search rag retrieval-augmented-generation mcp-server model-context-protocol ai-code-assistant vector-search code-navigation ollama qdrant github-copilot cursor-ai windsurf go php laravel python django flask fastapi code-intelligence ast-analysis embeddings llm-tools local-ai privacy-first offline-ai self-hosted on-premise zero-cost no-cloud private-code-search enterprise-ai secure-coding-assistant
Built with ❤️ for developers who want smarter AI code assistants
⭐ Star us on GitHub if RagCode helps your workflow!
Questions? Open an Issue • Read the Docs • Join Discussions