Skip to content
MCP server

Octocode

Local code search and symbol graph for AI assistants, built in Rust

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.29.2
Listing updated
2 days ago

About Octocode

Octocode is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Two layers sit behind the MCP tools. The always-on layer is a tree-sitter graph of files, symbols and their contains, imports, calls, extends and implements links, built from the current source with no index to go stale. The optional layer adds embedding-based search over an index you create with octocode index, and language-server tools when you start it with --with-lsp.

Structural search matches code by syntax shape, such as every .unwrap() call, which grep cannot express. Search can take several queries at once, filter by language, search documentation, or search Git history by meaning with a commits mode.

Defaults are local: FastEmbed models on CPU, no API key, and .gitignore respected; cloud embedding providers are opt-in. The project publishes a benchmark of 127 annotated queries against its own source, including a finding that a generic reranker hurt results. The website also links to Octomind cloud plans, which are separate from the CLI.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octocode"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octocode"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

graphrag
Graph lookup, relationship traversal and path finding.
structural_search
AST pattern matching across the tree.
lsp_goto_definition
Language-server go-to-definition.
lsp_find_references
Language-server find references.
lsp_hover
Language-server hover information.

What it does

Live symbol graph
Tree-sitter extracts files, symbols and relationships directly from current source.
Structural search
Finds code by AST pattern regardless of formatting or names.
Semantic and hybrid search
Combines vector and keyword search with configurable reranking.
LSP navigation
With --with-lsp, adds go-to-definition, references and hover from a language server.
Commit search
Searches Git history by meaning to find the change that introduced a pattern.
Local by default
Uses local embedding and reranking models with no API key.

Good for

  • Onboard to an unfamiliar codebase by tracing a flow across files
  • List every caller and importer before refactoring a function
  • Find all instances of a syntax pattern across a repo
  • Give Claude Code or Cursor repository-wide context
  • Locate which commit introduced a behaviour

Pricing

Open source

The CLI is free; Octomind cloud plans on the vendor site are separate

Prices change. Check octocode.muvon.io before you buy.

Octocode FAQ

Does it need an API key?

No. Default embedding and reranking run locally with FastEmbed; remote providers are optional.

Which clients does it support?

Claude Code, Codex CLI, Claude Desktop, Cursor and Windsurf are documented.

Do I have to index first?

Only for semantic search. Structural search, signatures and the dependency graph read current source without an index.

How do I install it?

Use the install script, brew install muvon/tap/octocode, cargo install octocode, or the npm package @muvon/octocode.

Is Octocode free?

Yes. Octocode is open source, so you can use and self-host it for free.

How do I add Octocode to Claude Code?

Run this command in your terminal: claude mcp add octocode -- npx -y @muvon/octocode

What are the best alternatives to Octocode?

The closest alternatives to Octocode are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Octocode

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools