octocode-mcp

@bgauryy741

MCP server for semantic code research and context generation on real-time using LLM patterns | Search naturally across public & private repos based on your permissions | Transform any accessible codebase/s into AI-optimized knowledge on simple and complex flows | Find real implementations and live docs from anywhere

code

llm

research

repository

knowledge-base

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
Research	Deep code exploration via LSP, local tools, GitHub API, packages, PRs
Local Search	Fast local codebase exploration with LSP semantic navigation
Plan	Evidence-based planning: Understand, Research, Plan, Implement
PR Reviewer	PR review across 7 domains with evidence-backed findings
Roast	Brutally honest code critique with file:line citations
Prompt Optimizer	Transform weak prompts into enforceable agent protocols
Documentation Writer	Generate comprehensive repo documentation in 6 phases

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}

Transport:

Language:

Created: 6/5/2025

Updated: 3/22/2026

Homepage:

https://octocode.ai/

Recommend MCP Servers 💡

asusevski/opendota-mcp-server

asusevski

An MCP server for accessing OpenDota API data to get Dota 2 statistics, match, and player info for LLMs/AI assistants.

2025-03-02

doris-mcp-server

apache

Doris MCP (Model Context Protocol) Server is a backend service built with Python and FastAPI. It implements the MCP, allowing clients to interact with it through defined "Tools". It's primarily designed to connect to Apache Doris databases, potentially leveraging Large Language Models (LLMs) for tasks like converting natural language queries to SQL (NL2SQL), executing queries, and performing metadata management and analysis.

2025-05-06

@notainc/gyazo-mcp-server

nota

An official Model Context Protocol server for Gyazo, enabling AI assistants to access, search, fetch, and upload images and their metadata (including OCR data) via the Gyazo API.

2025-01-26

me_mcp_server

jhgaylor

An MCP server designed to learn about and interact with a user's personal profile, providing features like job search instructions and access to personal resources (resume, LinkedIn, GitHub, website).

2025-04-16