Octocode
๐ฆ ๐ ๐ ๐ช ๐ง - Semantic code indexer with GraphRAG knowledge graph. Index your codebase, search in natural language, and expose everything v
What is Octocode?
Octocode is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐ฆ ๐ ๐ ๐ช ๐ง - semantic code indexer with graphrag knowledge graph. index your codebase, search in natural language, and expose everything v
๐ฆ ๐ ๐ ๐ช ๐ง - Semantic code indexer with GraphRAG knowledge graph. Index your codebase, search in natural language, and expose everything v
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- githubSearchCode
- githubGetFileContent
- githubViewRepoStructure
- githubSearchRepositories
- githubSearchPullRequests
Use Cases
Maintainer
Works with
Installation
NPM
npx -y octocode-mcpManual Installation
npx -y octocode-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Octocode
Octocode is a Rust-native semantic code indexer that builds a GraphRAG knowledge graph over your local codebase and exposes it to AI assistants via an MCP server. It uses vector embeddings (Voyage AI, OpenAI, Jina, or Google) to enable natural-language code search, structural AST pattern matching, and dependency graph traversal. Developers use it to let AI assistants understand and navigate large codebases without uploading code to a remote service.
Prerequisites
- An embedding provider API key โ Voyage AI is recommended (200M free tokens/month); alternatively OpenAI, Jina, or Google
- Rust 1.82+ if building from source, or macOS with Homebrew for the tap installation
- A local codebase to index
- An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
Install Octocode
Use the universal installer script, Homebrew on macOS, or build from source with Cargo.
# Universal installer (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/master/install.sh | sh
# macOS Homebrew
brew install muvon/tap/octocode
# From source
cargo install --git https://github.com/Muvon/octocodeSet your embedding API key
Export your Voyage AI key (or an alternative provider key). Octocode uses this to generate vector embeddings for semantic search.
# Voyage AI (recommended)
export VOYAGE_API_KEY="your-voyage-api-key"
# Or use OpenAI
export OPENAI_API_KEY="sk-..."
# Or Jina
export JINA_API_KEY="jina_..."Index your codebase
Navigate to your project directory and run the index command. Octocode will walk the source tree, generate embeddings, and build the GraphRAG knowledge graph locally.
cd /path/to/your/project
octocode indexTest semantic search from the CLI
Verify the index is working by running a natural-language search query before connecting an MCP client.
octocode search "authentication middleware"
octocode search "database connection pooling"Add Octocode MCP to your client configuration
Configure your MCP client to launch the octocode MCP server, pointing --path at the indexed project directory.
Restart your MCP client and query the codebase
Restart Claude Desktop or reload Cursor/Windsurf. You can now ask your AI assistant to search and explain code using natural language.
Octocode Examples
Client configuration
Add this to your claude_desktop_config.json or .cursor/mcp.json. Update the --path value to your project directory.
{
"mcpServers": {
"octocode": {
"command": "octocode",
"args": ["mcp", "--path", "/Users/yourname/projects/myapp"],
"env": {
"VOYAGE_API_KEY": "your-voyage-api-key"
}
}
}
}Prompts to try
Sample prompts to use with Octocode connected to your MCP client.
- "Search the codebase for how user authentication is handled"
- "Show the function signatures in the src/api/routes.rs file"
- "What files depend on the database module?"
- "Find all places where rate limiting is implemented"
- "Show me the GraphRAG relationships for the payment service"Troubleshooting Octocode
Index command fails with an embedding API error
Verify your VOYAGE_API_KEY (or alternative provider key) is exported in the shell where you run octocode. Check that you have network access to the embedding API endpoint.
MCP server starts but returns no search results
Make sure you ran `octocode index` inside the project directory before starting the MCP server. The --path argument must point to the same directory that was indexed.
Homebrew installation not found after brew install
Ensure Homebrew's bin directory is in your PATH. Run `brew link octocode` if the binary is not available, or use the universal installer script instead.
Frequently Asked Questions about Octocode
What is Octocode?
Octocode is a Model Context Protocol (MCP) server that ๐ฆ ๐ ๐ ๐ช ๐ง - semantic code indexer with graphrag knowledge graph. index your codebase, search in natural language, and expose everything v It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Octocode?
Install via npm with the command: npx -y octocode-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Octocode?
Octocode works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Octocode free to use?
Yes, Octocode is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Octocode Alternatives โ Similar Developer Tools Servers
Looking for alternatives to Octocode? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
โ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
โ 155.8kJava ้ข่ฏ & ๅ็ซฏ้็จ้ข่ฏๆๅ๏ผ่ฆ็่ฎก็ฎๆบๅบ็กใๆฐๆฎๅบใๅๅธๅผใ้ซๅนถๅใ็ณป็ป่ฎพ่ฎกไธ AI ๅบ็จๅผๅ
Gemini CLI
โ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
โ 87.3kโญ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
โ 86.0kModel Context Protocol Servers
CC Switch
โ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Octocode in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Octocode?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.