About
Octocode MCP Server connects AI coding assistants to code repositories and local codebases, providing deep code understanding through Language Server Protocol (LSP) integration. Key features of Octocode MCP Server: - GitHub and GitLab repository access: search code, explore pull requests, analyze usage patterns, and read implementations - Local filesystem tools: browse directories, find files, and search code within your workspace - LSP-based code intelligence: navigate to definitions, find references, and explore call hierarchies - Research-driven development workflow: structured code exploration and evidence-based planning - Pull request review capabilities across multiple domains
README
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)
[](https://cursor.com/en/install-mcp?name=octocode&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJvY3RvY29kZS1tY3BAbGF0ZXN0Il19)
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:
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 | | Researcher | Primary code research and exploration — local + external | | 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
Recommended quick links:
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 MCP Servers
AI Research Assistant
hamid-vakilzadeh
AI Research Assistant provides comprehensive access to millions of academic papers through the Semantic Scholar and arXiv databases. This MCP server enables AI coding assistants to perform intelligent literature searches, citation network analysis, and paper content extraction without requiring an API key. Key features include: - Advanced paper search with multi-filter support by year ranges, citation thresholds, field of study, and publication type - Title matching with confidence scoring for finding specific papers - Batch operations supporting up to 500 papers per request - Citation analysis and network exploration for understanding research relationships - Full-text PDF extraction from arXiv and Wiley open-access content (Wiley TDM token required for institutional access) - Rate limits of 100 requests per 5 minutes with options to request higher limits through Semantic Scholar
Linkup
LinkupPlatform
Linkup is a real-time web search and content extraction service that enables AI assistants to search the web and retrieve information from trusted sources. It provides source-backed answers with citations, making it ideal for fact-checking, news gathering, and research tasks. Key features of Linkup: - Real-time web search using natural language queries to find current information, news, and data - Page fetching to extract and read content from any webpage URL - Search depth modes: Standard for direct-answer queries and Deep for complex research across multiple sources - Source-backed results with citations and context from relevant, trustworthy websites - JavaScript rendering support for accessing dynamic content on JavaScript-heavy pages
Math-MCP
EthanHenrickson
Math-MCP is a computation server that enables Large Language Models (LLMs) to perform accurate numerical calculations through the Model Context Protocol. It provides precise mathematical operations via a simple API to overcome LLM limitations in arithmetic and statistical reasoning. Key features of Math-MCP: - Basic arithmetic operations: addition, subtraction, multiplication, division, modulo, and bulk summation - Statistical analysis functions: mean, median, mode, minimum, and maximum calculations - Rounding utilities: floor, ceiling, and nearest integer rounding - Trigonometric functions: sine, cosine, tangent, and their inverses with degrees and radians conversion support