# Octocode MCP **Intelligent Code Context for AI Systems** A Model Context Protocol (MCP) server enabling AI assistants to search, analyze, and extract insights from millions of GitHub repositories with enterprise-grade security and token efficiency. [![MCP Community Server](https://img.shields.io/badge/Model_Context_Protocol-Official_Community_Server-blue?style=flat-square)](https://github.com/modelcontextprotocol/servers) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/bgauryy/octocode-mcp) [![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/bgauryy/octocode-mcp)](https://archestra.ai/mcp-catalog/bgauryy__octocode-mcp)

---

### ✨ Featured On [![MCP Official Servers](https://img.shields.io/badge/MCP-Official%20Community%20Server-007ACC?style=for-the-badge&logo=github&logoColor=white)](https://github.com/modelcontextprotocol/servers) [![Awesome MCP Servers](https://img.shields.io/badge/Awesome-MCP%20Servers-FF6B6B?style=for-the-badge&logo=github&logoColor=white)](https://github.com/punkpeye/awesome-mcp-servers)

--- ## Table of Contents - [See It In Action](#see-it-in-action) - [Installation](#installation) - [More Examples](#more-examples) - [Overview](#overview) - [Tools](#tools) - [Commands](#commands) - [/research - Expert Code & Product Research](#research---expert-code--product-research) - [/plan - Research, Plan & Implement Complex Tasks](#plan---research-plan--implement-complex-tasks) - [/review_pull_request - Comprehensive PR Review](#review_pull_request---comprehensive-pr-review) - [/review_security - Security Audit](#review_security---security-audit) - [Documentation](#documentation) - [Community](#community) - [License](#license) --- ## See It In Action ### Full-Stack Application Built in Under 10 Minutes Watch AI assistant use Octocode to research, plan, and build a complete chat application with Express backend. **Prompt:** > **Use Octocode MCP for Deep Research** > > I want to build an application with chat (front-end) that shows a chat window to the user. > The user enters a prompt in the chat, and the application sends the prompt to an Express backend that uses AI to process the request. > > Add a return box (to show the message returned from the AI) and loaders to the UI. > I want to build an AI agent system in Node.js using LangChain and LangGraph. Can you research the latest patterns? > > Please conduct thorough research on how to create this in the best way possible. > Focus on repositories with good documentation and recent activity. > > - Do a deep research > - Create a plan document > - Initiate the plan and create the application **Phase 1: Research & Planning** https://github.com/user-attachments/assets/4225ab98-ae2f-46dc-b3ce-7d117e552b8c [Octocode Plan Document](https://gist.github.com/bgauryy/06504671c0d5fef727fe22c492e054d6) - Detailed architecture and step-by-step guide **Phase 2: Implementation** https://github.com/user-attachments/assets/2aaee9f1-3592-438a-a633-255b5cbbb8e1 **Result**: Production-ready full-stack application with authentication, real-time features, and best practices - **All in less than 10 minutes** --- ### Research and Build Fullstack Agentic Application with /research command in Under 10 Minutes **Why use the `/research` command?** Instead of manually searching through repositories and piecing together information, let the AI conduct comprehensive research for you: - **🎯 Intelligent Tool Orchestration**: Automatically selects and combines the right Octocode tools (repository search, code search, file content, PR analysis, repo structure) based on your research needs - **🧠 Smart Decision Making**: Makes strategic choices throughout the research flow—when to search broadly vs. specifically, which repositories to explore, and how to validate findings - **👥 Multi-Purpose Research**: Perfect for feature discovery (product managers), code understanding (developers), bug investigation, flow analysis, planning from scratch, dependency tracking, security audits, and more - **🔬 Specialized Workflows**: Handles Technical Research (code flows), Product Research (docs+code validation), Pattern Analysis (cross-repo comparison), Bug Investigation, Architecture Mapping, API Research, Security/Auth flows, and more - **🔍 Transparent Reasoning**: Shows you exactly which tools it's using, what it's searching for, and why at each step - **🎨 Adaptive Strategy**: Works across public repos, private organizations, and specific repositories with configurable depth (overview, deep dive, or cross-repo comparison) - **📊 Cross-Validated Results**: Leverages multiple Octocode tools to verify information from different sources and perspectives - **🚀 Actionable Insights**: Delivers implementation-ready plans with code examples, not just raw information **Prompt:** > /octocode/research How can I use LangChain, LangGraph, and similar open-source AI tools to create agentic > flows between agents for goal-oriented tasks? > Can you suggest UI frameworks I can use to build a full-stack AI application? https://github.com/user-attachments/assets/82ed97ae-57a9-46ae-9acd-828a509e711b --- ### Discover APIs, Frameworks, and Dive Into Internal Implementation Details Octocode excels at both **broad discovery** and **deep code analysis**. Whether you're exploring new APIs, finding frameworks, or understanding how popular libraries work under the hood, Octocode provides comprehensive answers in seconds. **First Prompt - Broad Discovery:** > list top repositories for: > > - Stock market APIs (Typescript) > - Cursor rules examples > - UI for AI > - Mobile development using React > - State management for React **What happens:** Octocode searches across GitHub to find the most popular and well-maintained repositories for each category, analyzing stars, activity, documentation quality, and recent updates. You get curated lists with context about each repository's strengths. **Second Prompt - Deep Implementation Analysis:** > How React implemented useState under the hood? **What happens:** Octocode dives into React's source code, traces the implementation flow, analyzes the relevant files (ReactHooks.js, ReactFiberHooks.js), and explains the internal mechanics including fiber architecture, hook state management, and dispatcher patterns—all with code references and detailed explanations. **The Power:** Move seamlessly from **discovering what exists** to **understanding how it works** in a single conversation. No manual repository hunting or code spelunking required. https://github.com/user-attachments/assets/c184d5d4-c9b6-40a1-a55a-41cb9b3ecc4f --- ## Installation ### ⚡ Quick Start (Recommended) The easiest way to install and configure Octocode is using the interactive CLI: ```bash npx octocode-cli ``` This will automatically: - Detect your installed IDEs (Cursor, Claude, Windsurf, etc.) - Verify your environment (Node.js, GitHub CLI) - Configure the MCP server correctly for each tool --- ### Standalone Binary (No Node.js Required) ```bash curl -fsSL https://raw.githubusercontent.com/bgauryy/octocode-mcp/main/install/install.sh | sh ``` See [Troubleshooting Guide](https://github.com/bgauryy/octocode-mcp/blob/main/docs/TROUBLESHOOTING.md) for common issues and solutions. --- ### npm / npx (Requires Node.js) #### Prerequisites - **Node.js** >= 20.0.0 - **GitHub Authentication** (choose one): - **GitHub CLI (recommended)**: Install from [cli.github.com](https://cli.github.com/) and run `gh auth login` - **Personal Access Token**: Create at [github.com/settings/tokens](https://github.com/settings/tokens) with scopes: `repo`, `read:user`, `read:org` ### Getting started First, install the Octocode MCP server with your client. **Standard config** works in most of the tools: ```js { "mcpServers": { "octocode": { "command": "npx", "args": [ "octocode-mcp@latest" ] } } } ``` > **Note**: This configuration uses GitHub CLI authentication. For Personal Access Token, see the [Authentication Guide](#authentication-methods) below. [

](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522octocode%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522octocode-mcp%2540latest%255D%257D) [

](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522octocode%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522octocode-mcp%2540latest%255D%257D)

Amp

Add via the Amp VS Code extension settings screen or by updating your settings.json file: ```json "amp.mcpServers": { "octocode": { "command": "npx", "args": [ "octocode-mcp@latest" ] } } ``` **Amp CLI Setup:** Add via the `amp mcp add` command below: ```bash amp mcp add octocode -- npx octocode-mcp@latest ```

Claude Code

Use the Claude Code CLI to add the Octocode MCP server: ```bash claude mcp add octocode -- npx octocode-mcp@latest ``` **With local tools enabled:** ```bash cl