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-16 · ★ 475 · #14 OF 208 MAINTAINED DOCUMENTATION · VERIFIED 2026-09-18

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.1 · 2026-09-15

Release Summary · Updated Rust dependencies to newer versions, improving the project’s maintenance and compatibility. · Other Changes · 1 maintenance, dependency, and tooling update not listed individually.

0.26.0 · 2026-09-14

Release Summary · This release adds support for listing and parsing ONNX providers (86a76b8a). Embedding providers can now be shared across processes for improved reuse and consistency (407dc05a), alongside updated…

0.25.1 · 2026-09-11

Release Summary · Updated project dependencies to refreshed versions for improved compatibility and maintenance (e6c586bd, bd7a8a5c). · Other Changes · 2 maintenance, dependency, and tooling updates not listed…

04 · Who maintains Octocode

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

  1. Octobrain Persistent memory for AI assistants with semantic search and knowledge graph relationships. ★ 13
  2. Octofs Standalone MCP filesystem tools server - view, edit, shell, workdir. ★ 12

05 · Facts

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

06 · Octocode FAQ

Is Octocode still maintained?

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

What can Octocode do?

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).

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