Octocode MCP

A server for semantic code search and context generation across public and private repositories using LLMs.

GitHub

Octocode: Research Driven Development for AI

Stop Guessing. Start Knowing.

Empower your AI assistant with the skills of a Senior Staff Engineer.

octocode.ai

Installation

Prerequisites: GitHub authentication required. See Authentication Setup.

Recommended: Octocode CLI

npx octocode-cli

Interactive setup wizard with GitHub OAuth, MCP server installation, and skills marketplace.

Alternative Methods

One-Click Install (Cursor)

Manual MCP Configuration

Add to your MCP configuration file:

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": ["octocode-mcp@latest"]
    }
  }
}

Research Skill (Direct Install)

npx add-skill https://github.com/bgauryy/octocode-mcp/tree/main/skills/octocode-research

MCP Server

The Octocode MCP Server connects your AI assistant to code:

GitHub & GitLab: Search repositories, find usage patterns, read implementations, explore PRs
Local Tools: Search code, browse directories, find files in your local codebase
LSP Intelligence: Go to Definition, Find References, Call Hierarchy -- compiler-level understanding

https://github.com/user-attachments/assets/de8d14c0-2ead-46ed-895e-09144c9b5071

Skills

Agent Skills are a lightweight, open format for extending AI agent capabilities. Skills index: skills/README.md

Skill	What it does
Researcher	Code search & exploration — local LSP + external (GitHub, npm/PyPI)
Research	Multi-phase research with sessions, checkpoints, state persistence
Engineer	Understand, write, analyze, audit code — AST + LSP + dependency graph
Plan	Evidence-based planning: Understand > Research > Plan > Implement
RFC Generator	Formal technical decisions with alternatives, trade-offs, and recommendations
PR Reviewer	PR & local code review across 7 domains with LSP flow tracing
Roast	Brutal code critique with file:line citations and severity levels
Prompt Optimizer	Turn weak prompts into enforceable agent protocols
Doc Writer	6-phase pipeline producing 16+ validated docs

https://github.com/user-attachments/assets/5b630763-2dee-4c2d-b5c1-6335396723ec

Documentation

For the full documentation index, start here: docs/README.md

The Manifest

"Code is Truth, but Context is the Map." -- Read the Manifest for Research Driven Development to understand the philosophy behind Octocode.

Contributing

See the Development Guide for monorepo setup, testing, and contribution guidelines.

_{Built with care for the AI Engineering Community}

Related Servers

Scout Monitoring MCP

sponsor

Put performance and error data directly in the hands of your AI assistant.

Alpha Vantage MCP Server

sponsor

Access financial market data: realtime & historical stock, ETF, options, forex, crypto, commodities, fundamentals, technical indicators, & more

UnityNaturalMCP

An MCP server implementation for the Unity game engine that enables a natural user experience.

mcpcodeserver

Instead of direct calling MCP tools, mcpcode server transforms MCP tool calls into TypeScript programs, enabling smarter, lower-latency orchestration by LLMs.

AI Image Generation

Generate images using the Together AI API. Supports custom aspect ratios, save paths, and batch generation.

OpenMM MCP

AI-native crypto trading server with 13 tools for market data, order execution, grid strategies, and Cardano DeFi across multiple exchanges.

Unreal Engine Code Analyzer

Analyzes Unreal Engine source code to provide context for AI assistants.

SeedDream 3.0 FAL

Generate images using Bytedance's SeedDream 3.0 model via the FAL AI platform. Requires a FAL AI API key.

ABP.IO MCP Server

An MCP server for ABP.IO that enables AI models to interact with your ABP applications and framework.

Kaggle MCP

Get access to Kaggle's datasets, models, competitions, notebook and benchmarks.

PageSpeed Analyzer MCP

Analyzes website performance, SEO, and accessibility using PageSpeed Insights API.

Cupertino

Apple Documentation MCP Server - Search Apple docs, Swift Evolution, and sample code