Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/Muvon/octocode
cd octocodeThen follow the repository README for any remaining dependency or build steps.
2
Register it in Claude Code
claude mcp add -e "VOYAGE_API_KEY=${VOYAGE_API_KEY}" octocode -- octocode mcp --path /path/to/your/projectReplace any placeholder paths in the command with the real path on your machine.
Required:
VOYAGE_API_KEY+ 1 optional3
Make your agent remember this setup
octocode's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Semantic code search with natural language support
- GraphRAG knowledge graph for relationship discovery
- Multi-language support including Rust, Python, JS, TS, Go, and more
- AI-powered features for smart commits and code reviews
- Local-first design with intelligent LanceDB optimization
Tools 2
searchPerform natural language semantic search across the indexed codebaseindexIndex the codebase to build the knowledge graphEnvironment Variables
VOYAGE_API_KEYrequiredAPI key for Voyage AI embeddingsOPENROUTER_API_KEYOptional API key for OpenRouter LLM featuresTry it
→Search for the implementation of HTTP request handling in this codebase.
→Find all files related to authentication and middleware logic.
→Explain the architecture of the current project based on the knowledge graph.
→Identify which modules are responsible for database interactions.
Original README from Muvon/octocode
Octocode - Intelligent Code Indexer and Graph Builder
© 2025 Muvon Un Limited (Hong Kong) | Website | Product Page
<a href="https://glama.ai/mcp/servers/Muvon/octocode"> </a>🚀 Overview
Octocode is a powerful code indexer and semantic search engine that builds intelligent knowledge graphs of your codebase. It combines advanced AI capabilities with local-first design to provide deep code understanding, relationship mapping, and intelligent assistance for developers.
✨ Key Features
- 🔍 Semantic Code Search - Natural language queries with multi-query support
- 🕸️ Knowledge Graph (GraphRAG) - Automatic relationship discovery between files
- 🌐 Multi-Language Support - Rust, Python, JavaScript, TypeScript, Go, PHP, C++, Ruby, and more
- 🧠 AI-Powered Features - Smart commits, code review, memory system with semantic search
- 🔌 MCP Server Integration - Built-in Model Context Protocol server with LSP support
- ⚡ Performance & Flexibility - Intelligent LanceDB optimization, local/cloud embedding models
📦 Quick Installation
# Universal install script (Linux, macOS, Windows)
curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/master/install.sh | sh
Alternative methods:
- Download from GitHub Releases
- Install with Cargo:
cargo install --git https://github.com/Muvon/octocode
For detailed installation instructions, see Installation Guide.
🔑 API Keys Setup
⚠️ Required for functionality:
# Required: Voyage AI (embeddings) - 200M free tokens/month
export VOYAGE_API_KEY="your-voyage-api-key"
# Optional: OpenRouter (LLM features)
export OPENROUTER_API_KEY="your-openrouter-api-key"
Get your free API keys:
- Voyage AI: Get free API key (200M tokens/month free)
- OpenRouter: Get API key (optional, for AI features)
🚀 Quick Start
# 1. Index your codebase
octocode index
# 2. Search with natural language
octocode search "HTTP request handling"
# 3. Multi-query search for comprehensive results
octocode search "authentication" "middleware"
# 4. AI-powered git workflow
octocode commit --all
# 5. Start MCP server for AI assistants
octocode mcp --path /path/to/your/project
📚 Complete Documentation
📖 Quick Navigation
- Installation Guide - Detailed installation methods and building from source
- Getting Started - First steps and basic workflow
- API Keys Setup - Complete API configuration guide
- Configuration Guide - Configuration system, templates, and customization
- Commands Reference - Complete command reference with examples
- Advanced Usage - Advanced features and workflows
- MCP Integration - Model Context Protocol server setup
- LSP Integration - Language Server Protocol integration
- Memory System - Memory management and semantic search
- Release Management - AI-powered release automation
- Architecture - Core components and system design
- Performance - Performance metrics and optimization
- Contributing - Development setup and contribution guidelines
🌐 Supported Languages
| Language | Extensions | Features |
|---|---|---|
| Rust | .rs |
Full AST parsing, pub/use detection, module structure |
| Python | .py |
Import/class/function extraction, docstring parsing |
| JavaScript | .js, .jsx |
ES6 imports/exports, function declarations |
| TypeScript | .ts, .tsx |
Type definitions, interface extraction |
| Go | .go |
Package/import analysis, struct/interface parsing |
| PHP | .php |
Class/function extraction, namespace support |
| C++ | .cpp, .hpp, .h |
Include analysis, class/function extraction |
| Ruby | .rb |
Class/module extraction, method definitions |
| JSON | .json |
Structure analysis, key extraction |
| Bash | .sh, .bash |
Function and variable extraction |
| Markdown | .md |
Document section indexing, header extraction |
🔒 Privacy & Security
- 🏠 Local-first option: FastEmbed and SentenceTransformer run entirely offline (macOS only)
- 🔑 Secure storage: API keys stored locally, environment variables supported
- **📁 Respects .gi