Octocode MCP
A server for semantic code search and context generation across public and private repositories using LLMs.
Octocode: Research Driven Development for AI
Stop Guessing. Start Knowing.
Empower your AI assistant with the skills of a Senior Staff Engineer.
Installation
Prerequisites: GitHub authentication required. See Authentication Setup.
Recommended: Octocode CLI
npx octocode-cli install
Interactive setup wizard with GitHub OAuth, MCP server installation, and skills marketplace. Pass --ide <ide> for non-interactive install (e.g. npx octocode-cli install --ide cursor).
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
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.
関連サーバー
Alpha Vantage MCP Server
スポンサーAccess financial market data: realtime & historical stock, ETF, options, forex, crypto, commodities, fundamentals, technical indicators, & more
PyVista MCP Server
An MCP server for 3D visualization and data analysis using the PyVista library.
Trade-MCP
A modular trading automation project using the Zerodha Kite Connect API for tool-based and resource-based automation.
MCP Proxy Server
Aggregates multiple MCP resource servers into a single interface with stdio/sse support.
Scout Monitoring MCP
Scout's official MCP pipes error, trace and metric data from production to your AI agent
Remote MCP Server (Authless)
An example of a remote MCP server deployable on Cloudflare Workers without authentication.
ForeverVM
Run Python in a code sandbox.
Remote MCP Server (Authless)
A remote MCP server deployable on Cloudflare Workers without authentication.
Tempo MCP Server
An MCP server for querying distributed tracing data from Grafana Tempo.
LaTeX to MathML MCP Server
Converts LaTeX mathematical expressions to MathML format using MathJax-node.
MCPR
Expose R functions through the Model Context Protocol (MCP) for seamless integration with AI assistants.