Octocode MCP Server

Give your AI assistant a brain for your codebase. Octocode transforms your project into a navigable knowledge graph that Claude, Cursor, and other AI agents can search, understand, and navigate. Its 7 documented tools cluster into lsp, semantic, read & search, graphrag. It runs locally over stdio via the published package.

People who work with code search, developer tools and graphrag and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Rust.

VERIFIED ACTIVE

LAST COMMIT 2026-09-30 · ★ 477 · #16 OF 221 MAINTAINED DOCUMENTATION · VERIFIED 2026-09-30

Apache-2.0 · Rust servers · how we verify → /methodology

01 · Install Octocode

before you install - you'll need

Set VOYAGE_API_KEY, OPENROUTER_API_KEY, OPENAI_API_KEY, JINA_API_KEY, GOOGLE_API_KEY before connecting.

Claude Code

claude mcp add muvon-octocode -- npx -y @muvon/octocode

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "muvon-octocode": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octocode"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · Claude Desktop extension (.mcpb bundle)

license Apache-2.0 - declared in the repository

npm package @muvon/octocode - published under the repo owner's npm scope (@muvon)

registry namespace io.github.Muvon is GitHub-verified and matches the repo owner

03 · What Octocode can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can find code by meaning - "authentication flow", "error handling", "database queries", view file structure - function signatures, class definitions, imports, and find all usages of a symbol across the workspace (requires --with-lsp).

Capability map

Tools grouped from the project's README - what Octocode lets an agent do.

Lsp

3 tools - e.g. Jump to a symbol's definition (requires --with-lsp); Find all usages of a symbol across the workspace (requires --with-lsp); Type info and documentation for a symbol (requires --with-lsp)

lsp_goto_definition · lsp_find_references · lsp_hover

Semantic

1 tool - e.g. Find code by meaning - "authentication flow", "error handling", "database queries"

semantic_search

read & search

1 tool - e.g. View file structure - function signatures, class definitions, imports

view_signatures

Graphrag

1 tool - e.g. Always-on file/symbol graph - search nodes, inspect relationships, and find paths without indexing

graphrag

Structural

1 tool - e.g. AST pattern matching - find .unwrap() calls, new instantiations, specific patterns

structural_search

Latest releases

0.26.4 · 2026-09-30

Improvements & Optimizations · refresh locked dependencies 45133528

0.26.3 · 2026-09-27

Release Summary · MCP tool listings now include cache hints and use the current server configuration type. Commit headers drop scopes that exceed the header limit, generated claims are audited against source material…

0.26.2 · 2026-09-18

Release Summary · This release adds per-file and per-batch indexing progress when using verbose mode (9a358956). Indexing reliability is improved through checkpointing after stored batches, alongside refreshed usage…

04 · Who maintains Octocode

Octocode is maintained by muvon. We track 3 MCP servers from muvon - 3 actively maintained, 507 combined GitHub stars, oldest repo from Jun 2025. Full record: all servers from muvon.

05 · Facts

repository: github.com/muvon/octocode
website: https://octocode.muvon.io/
category: documentation - ranked #16 of 221 actively-maintained documentation servers as of 2026-09-30.
release cadence: 10+ releases in the last 90 days (latest 2026-09-30)
registry: io.github.Muvon/octocode (active, first published 2026-03-11 · 18 versions)
packages: npm:@muvon/octocode · mcpb:https://github.com/Muvon/octocode/releases/download/0.26.3/octocode-0.26.3-aarch64-apple-darwin.mcpb · mcpb:https://github.com/Muvon/octocode/releases/download/0.26.3/octocode-0.26.3-aarch64-pc-windows-msvc.mcpb · mcpb:https://github.com/Muvon/octocode/releases/download/0.26.3/octocode-0.26.3-aarch64-unknown-linux-musl.mcpb · mcpb:https://github.com/Muvon/octocode/releases/download/0.26.3/octocode-0.26.3-x86_64-apple-darwin.mcpb · mcpb:https://github.com/Muvon/octocode/releases/download/0.26.3/octocode-0.26.3-x86_64-pc-windows-msvc.mcpb · mcpb:https://github.com/Muvon/octocode/releases/download/0.26.3/octocode-0.26.3-x86_64-unknown-linux-musl.mcpb

06 · Octocode FAQ

Is Octocode still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-30 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Octocode do?

How do I install Octocode?

Run `npx -y @muvon/octocode`. The README documents 5 environment variables (VOYAGE_API_KEY, OPENROUTER_API_KEY, OPENAI_API_KEY…) to set first. Set VOYAGE_API_KEY, OPENROUTER_API_KEY, OPENAI_API_KEY, JINA_API_KEY, GOOGLE_API_KEY before connecting. You can also paste the ready-made client config above.

Does Octocode run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Octocode

Alternatives to Octocode

Maintained documentation servers if Octocode isn't the fit.

Pairs well with

Servers that cover what Octocode doesn't - only shown when the pairing reason fits the companion.

More documentation MCP servers · Mnema - Shared Brain for You and Your AI Agents · Context · Gnosis MCP · Artel · Nifra docs

More Rust MCP servers · Octofs · Foremerge · Codeloupe MCP · Sidereon · Dazai - Burn After Reading Secret (motokano) · see all