Octocode
Rank #420io.github.Muvon/octocode
AI-powered code indexer with semantic search and knowledge graphs
What you can do with Octocode
Octocode is a local-first code intelligence tool that indexes a repository into a map of files, symbols, imports and calls, and exposes semantic, structural and GraphRAG search to an agent through an MCP server.
- Find code by meaning across a large repository
- Read file signatures without loading whole files
- Match AST patterns with structural search
- Trace relationships and paths between code nodes
- Search commit history
- Use LSP go-to-definition and references through the agent
What Octocode can and cannot do
The MCP server exposes semantic_search, view_signatures, graphrag and structural_search; starting with --with-lsp adds language-server tools for definitions, references, hover, symbols and completion. Commit search, commit-message generation and code review run through the CLI.
- semantic_search
- view_signatures
- graphrag
- structural_search
- lsp_goto_definition
- lsp_find_references
- lsp_hover
- lsp_document_symbols
- lsp_workspace_symbols
- lsp_completion
- Works on a local checkout; GitHub API operations such as issues or pull requests are not documented
- Indexed GraphRAG features need indexing and GraphRAG enabled in config
- Cloud embedding providers receive the code chunks; use local FastEmbed models for fully offline use
- LSP tools need a language server installed and named with --with-lsp
- Supports 17 languages
What you need before using Octocode
The registry listing declares no required environment variables or authentication. This is declared metadata, not a verified install — the repository README is the authority.
Declared by the Official MCP Registry, last synced Oct 16, 2026. Not independently verified by MCP Toplist.
- Runtime
- Rust binary via install script, Homebrew or cargo install octocode
- Credentials
- Optional: Voyage, OpenAI, Jina or Google key for embeddings, OpenRouter key for LLM features; local embeddings need none
- Also needed
- A language server (e.g. rust-analyzer) for the LSP tools
Connect Octocode and confirm it works
- Install with brew install muvon/tap/octocode, cargo install octocode, or the install.sh script
- Optionally export VOYAGE_API_KEY or another provider key
- Run octocode index inside the project
- Add the server with command octocode and args mcp --path /your/project
claude mcp add octocode -- npx -y @muvon/octocode mcpPublished as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
[mcp_servers.octocode]
command = "npx"
args = ["-y", "@muvon/octocode", "mcp"]Add to ~/.codex/config.toml.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": [
"-y",
"@muvon/octocode",
"mcp"
]
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config).
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": [
"-y",
"@muvon/octocode",
"mcp"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project).
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
{
"servers": {
"octocode": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@muvon/octocode",
"mcp"
]
}
}
}Save as .vscode/mcp.json in your workspace.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": [
"-y",
"@muvon/octocode",
"mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": [
"-y",
"@muvon/octocode",
"mcp"
]
}
}
}Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-aarch64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-apple-darwin.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-pc-windows-msvc.mcpb` — install it through your client’s extension manager.
Published as mcp bundle `https://github.com/Muvon/octocode/releases/download/0.26.7/octocode-0.26.7-x86_64-unknown-linux-musl.mcpb` — install it through your client’s extension manager.
Run octocode search "authentication middleware" in the project, then ask the agent the same question via semantic_search.
Expected: Ranked code locations that implement authentication middleware, with file paths and snippets.
When to choose another server
- Repomix#39
You want the whole repository packed into one file rather than indexed search.
- GitHub MCP Server#176
You need GitHub API actions such as issues and pull requests.
Compared side by side in GitHub MCP servers.
What changed, and when this was checked
- First listed
- Jun 1, 2025
- Latest version published
- Oct 11, 2026
- Version history
- 22 versions tracked (below)
- Requirements evidence
- Declared by the Official MCP Registry, last synced Oct 16, 2026. Not independently verified by MCP Toplist.
- Profile checked
- Oct 8, 2026 against README
- Ranking data as of
- Oct 16, 2026
- Official MCP ↗listed since Apr 25, 2026 · still listed
- Glama ↗listed since Apr 26, 2026 · still listed
- PulseMCP ↗listed since Jun 4, 2026 · still listed
Do you maintain Octocode? to correct or enrich this profile.
Available versions (22)
| Version | Published |
|---|---|
| 0.26.7 | Oct 11, 2026 |
| 0.26.6 | Oct 9, 2026 |
| 0.26.4 | Sep 30, 2026 |
| 0.26.3 | Sep 27, 2026 |
| 0.26.2 | Sep 19, 2026 |
| 0.26.1 | Sep 15, 2026 |
| 0.26.0 | Sep 14, 2026 |
| 0.25.1 | Sep 11, 2026 |
| 0.25.0 | Sep 5, 2026 |
| 0.24.0 | Sep 2, 2026 |
| 0.23.1 | Aug 31, 2026 |
| 0.23.0 | Aug 29, 2026 |
| 0.22.0 | Aug 22, 2026 |
| 0.21.0 | Aug 17, 2026 |
| 0.20.2 | Aug 4, 2026 |
| 0.20.1 | Aug 3, 2026 |
| 0.20.0 | Aug 1, 2026 |
| 0.19.0 | Jul 26, 2026 |
| 0.18.1 | Jul 11, 2026 |
| 0.13.0 | Apr 4, 2026 |
| 0.11.0 | Mar 11, 2026 |
| 0.1.0 | Nov 25, 2024 |
Ranks ahead of 143,976 of 144,396 servers on MCP Toplist.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.Muvon%2Foctocode)<a href="https://mcptoplist.com/server/io.github.Muvon%2Foctocode"><img src="https://mcptoplist.com/badge/io.github.Muvon%2Foctocode.svg" alt="MCP Toplist: Top 1% of 144,396" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Frequently asked questions
- Who maintains Octocode?
- Octocode is maintained by muvon, which publishes 4 MCP servers (74 total versions) tracked on MCP Toplist.
- Is Octocode listed on the Official MCP Registry?
- Yes — Octocode is listed on the Official MCP Registry, alongside Glama and PulseMCP.
- How many versions does Octocode have?
- MCP Toplist tracks 22 versions of Octocode, most recently published on Oct 11, 2026.
- Where can I find the source code for Octocode?
- The source code for Octocode is hosted at github.com/muvon/octocode.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.