octocode MCP Server

Use This MCP server To

Find where login is handled in a project I inherited See which files break if I change one module Get a quick tour of an unfamiliar codebase Ask which parts of my project use a given function Answer questions about my code without pasting files into chat

README

Structural Code Intelligence for AI Agents — MCP Server + Knowledge Graph + Semantic Search

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.

🚀 Quick Start • 🤖 MCP Integration • 📖 Documentation • 🌐 Website

🤖 Built for AI Agents

The Problem: AI assistants are blind to your codebase. They can't search your files, understand dependencies, or remember context across sessions.

The Solution: Octocode's MCP server gives AI agents:

🔍 Semantic search — Find code by meaning, not keywords
🕸️ Knowledge graph — Navigate imports, calls, and dependencies
📝 Code signatures — View structure without reading entire files
🧭 LSP precision — Go-to-definition, find-references, and hover docs via your language server

Works with: Claude Desktop • Cursor • Windsurf • Any MCP-compatible AI

// Add to your AI assistant config
{
  "mcpServers": {
    "octocode": {
      "command": "octocode",
      "args": ["mcp", "--path", "/your/project"]
    }
  }
}

Now your AI assistant can:

octocode FAQ

Which apps does this work with?

Claude Desktop, Cursor, VS Code, Cline, and Windsurf, plus anything else that speaks MCP.

Do I need a paid key?

Not necessarily — it can run with local search models and no key at all, and you can add a paid one later for sharper results.

Does my code get uploaded anywhere?

The project is built to be local-first, so the index lives on your own computer.

Can I use this to find the file that handles payments?

Yes — ask in plain words and you get the file back, along with what imports or calls it.

How hard is setup?

One install command through Homebrew or a script, then paste a short block into your assistant's settings.

What does it do that ordinary search doesn't?

It matches on meaning as well as exact words, and it follows how files depend on each other.