AmanMCP
Local RAG for your codebase. Zero config. Privacy-first.
Alpha Software - Use at your own risk. Full disclaimer
Quick Start
Prerequisite: Ollama installed (brew install ollama)
# Install
brew tap Aman-CERP/amanmcp && brew install --cask amanmcp
# Initialize (auto-starts Ollama, pulls model, indexes)
cd your-project && amanmcp init
# Restart Claude Code. Done.
Ask Claude: "Search my codebase for authentication"
What It Does
flowchart LR
subgraph Local["Your Machine (100% Local)"]
Code[(Codebase)]
AmanMCP["AmanMCP<br/>BM25 + Vector"]
end
Claude["Claude AI"]
Code -->|index| AmanMCP
Claude <-->|query| AmanMCP
AmanMCP -->|context| Claude
style Local fill:#d5f4e6,color:#000
style AmanMCP fill:#27ae60,color:#fff
style Claude fill:#3498db,color:#fff
Key features: Hybrid search (BM25 + semantic) | AST-aware chunking | AmanGraph relationship overlay | PDF text extraction | explicit language-support tiers | < 100ms queries
Essential Commands
What Claude Can Do
When connected via MCP, Claude has these tools:
The structured SDK-registered MCP tools are the canonical integration path. The
legacy in-process Server.CallTool markdown wrapper remains available for older
tests and compatibility callers, but it is deprecated and targeted for removal
after v1.0.0.
Try: "Find the function that handles database connections"
Documentation
Explore the Documentation
Browse our comprehensive documentation organized by topic. Each category highlights key documents to help you quickly find what you need.
Articles - Deep Dives & Insights
→ Articles documentation overview
Concepts - Core Ideas & Theory
→ Concepts documentation overview
Guides - Step-by-Step Instructions
→ Guides documentation overview
Research - Investigations & Decisions
→ Research documentation overview
Contributing - Developer Resources
→ View all 3 contributing documents
Reference - Technical Specifications
Roadmap
Contributions welcome in priority areas.
Privacy
- 100% Local - No internet required after install
- No Telemetry - We don't collect any data
- No Cloud - Your code never leaves your machine
Install Options
Technology
Contributing
See CONTRIBUTING.md for development setup and guidelines.
Priority areas: Tier 1 language support, Windows support, performance.
License
Apache 2.0 License - see LICENSE
Disclaimer
AmanMCP is experimental software in active development. By using this software, you acknowledge this is alpha/beta quality software, accept full responsibility for any issues, and understand the developers are not liable for data loss, system issues, or other problems.
Acknowledgments
Model Context Protocol by Anthropic | coder/hnsw | Ollama | tree-sitter | Qwen
Made with care by the AmanERP Team · "It just works."