local_fire_departmentHoneystax
search⌘K
loginLog Inperson_addSign Up
layers
HONEYSTAX TERMINAL v1.0
HomeNewsSavedSubmit
Back to the live board
O

octocode-mcp

MCP Server

MCP server for semantic code research and context generation on real-time using LLM patterns | Search naturally acros...

Copy the install, test the workflow, then decide if it earns a permanent slot.

802
Why nowMoving now

Fresh repo activity plus visible builder pull. This is the kind of tool people test before it turns obvious.

DecisionHigh-conviction move

Copy the install, test the workflow, then decide if it earns a permanent slot.

Trial costFast eval

You can test this quickly and remove it cleanly if it misses.

Risk35/100

GitHub health 42/100. no security policy. 6 open issues make this testable, but not something to trust blind.

What You Are Adopting

AI Agent

Universal

Model

Multiple

Build Time

Instant

Test This In Your Stack

One command inClean rollbackLow commitment
settingsRegistryAdds a named entry to Claude config. One command to remove.

Fastest way to find out if octocode-mcp belongs in your setup.

Copy the install command, run a real test, and back it out cleanly if it slows you down.

Try now
claude mcp add octocode-mcp -- npx octocode-mcp

Run this first. You will know quickly if the workflow earns a permanent slot.

Back out
claude mcp remove octocode-mcp

No messy cleanup loop. If it misses, remove it and keep moving.

Install Location

~/  └─ .claude.json    └─ mcp_servers/      └─ octocode-mcp ← registers here

About

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. An open-source mcp server for the AI coding ecosystem.

README

Octocode: Research Driven Development for AI

Octocode Logo

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)

Install in 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
react_vue_comparisson.mp4

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
octocode-skill.mp4

Documentation

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

Recommended quick links:

  • Authentication Setup
  • Configuration Reference
  • Local Tools + LSP Reference
  • CLI Skills Guide
  • Skills Index
  • Troubleshooting

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

Tech Stack

Go
Open Live ProjectAudit Repo

Reviews0

Log in to write a review.

ActiveLast commit 8d ago
bug_report6open issues
Submitted March 21, 2026

auto_awesomeYour strongest next moves after octocode-mcp