Octocode MCP

🚀 Octocode MCP

The Octocode MCP is a top - notch AI code assistant that enables advanced search and discovery across GitHub. It allows users to access millions of repositories and packages in the GitHub and npm ecosystems instantly, transforming the AI assistant into an expert code researcher.

🌐 For More Details - octocode.ai

📚 For Technical Details - Technical Summary

🐳 For Docker Setup - Docker Guide

💬 Join Our Community - Discord - Follow this for useful updates and discussions

✨ Features

The Octocode MCP is the ideal code assistant that can help users understand anything. Instead of manually browsing repositories, users can ask questions such as:

• "How did React implement concurrent rendering?"
• "Show me authentication patterns in Next.js applications"
• "Find examples of how to use this specific API"
• "What's the architecture of this library?"
• "How do I use this MCP tool effectively?"

🌟 Featured On

modelcontextprotocol - Official Community MCP Server

Community Collections

MCP Directories & Tools

🎯 Who Is This For?

For Developers

Developers can navigate complex multi - repo architectures, understand organizational issues at scale, and generate custom documentation on - demand from real code examples. They can create contextual documentation directly in their IDE or ask OctoCode to learn from any repository and implement similar patterns in their current project.

For Product & Engineering Managers

Product and engineering managers can gain unprecedented visibility into application behavior through semantic code search, track development progress across teams, and understand the real implementation behind product features.

For Security Researchers

Security researchers can discover security patterns, vulnerabilities, and compliance issues across both public and private repositories with advanced pattern matching and cross - codebase analysis.

For Large Organizations

Large organizations can dramatically increase development velocity by enabling teams to instantly learn from existing codebases, understand cross - team implementations, and replicate proven patterns, thus transforming institutional knowledge into actionable development acceleration.

🚀 Quick Start

1. Install Prerequisites

macOS/Linux:

# Install Node.js 18.12+
brew install node

# Install GitHub CLI
brew install gh

Windows:

# Install using WinGet (recommended)
winget install Microsoft.PowerShell  # PowerShell 7+ for better security
winget install GitHub.cli
winget install OpenJS.NodeJS

# Or using Chocolatey
choco install powershell-core nodejs github-cli

# Or using Scoop
scoop install gh nodejs

2. Authenticate

# Login to GitHub (opens browser)
gh auth login

# Login to NPM (for package research)
npm login

3. Add to Claude Desktop

# For Claude Desktop users
claude mcp add octocode npx 'octocode-mcp@latest'

Or Add to MCP Configuration Manually

{
  "octocode-mcp": {
    "command": "npx",
    "args": ["octocode-mcp"]
  }
}

That's it! Octocode automatically works with your organization's private repositories.

🐳 Docker Support

You can run Octocode MCP in a Docker container while maintaining full GitHub CLI authentication. It is perfect for consistent environments and deployment.

🛠️ What You Can Do

Deep Project Research & Analysis

• Issue Search & Analysis: Understand project challenges, feature requests, and bug patterns.
• Commit History Research: Trace feature implementations and bug fixes across time.
• Pull Request & Code Review Analysis: Access actual code diffs and understand development workflows.
• Project Progress Tracking: Monitor development velocity and team collaboration patterns.

Core GitHub Research

• Repository Discovery: Find repositories by topic, language, and activity.
• Code Search: Find exact patterns and implementations across millions of repositories.
• Cross - Repository Flow Understanding: Connect related changes across multiple repositories.
• Repository Architecture: Navigate and understand project structures.

Package Ecosystem Tools

• NPM Package Discovery: Analyze Node.js packages with comprehensive metadata.
• Python Package Integration: Explore PyPI packages with cross - ecosystem comparison.
• Package Analysis: Deep - dive into versions, dependencies, and repository connections.

Advanced Research Capabilities

• Code Pattern Discovery: Identify implementation patterns and best practices.
• Security & Compliance Research: Search for security patterns across codebases.
• Team Collaboration Analysis: Understand code review processes and team dynamics.
• Real - time Documentation: Generate custom docs from live code for any topic.

📚 For detailed technical architecture, tool specifications, and implementation details, see Technical Summary

📦 DXT Extension

This project is available as a Desktop Extension (DXT) for easy installation in AI applications like Claude Desktop.

Quick DXT Setup

# Install dependencies
yarn install

# Build the DXT package
yarn dxt:pack

The generated octocode-mcp.dxt file can be installed in Claude Desktop by simply clicking on it.

DXT Scripts:

• yarn dxt:validate - Validate the manifest.json file.
• yarn dxt:pack - Build and package the extension.
• yarn dxt:release - Full release pipeline (build → pack → sign → verify).

💡 Best Practices

Ask Natural Questions

• "How does authentication work in this project?"
• "What libraries implement this pattern?"
• "Show me NPM packages that solve X problem"
• "How has this approach evolved over time?"

Let AI Guide Discovery

• Start with broad queries - the system will intelligently narrow down.
• Trust the smart fallbacks - automatic retry with alternatives.
• Build on previous searches - maintain context for deeper exploration.
• Works everywhere - public, private, and organization repositories.

🔧 Troubleshooting

Cross - Platform Commands

# Check GitHub CLI status
gh auth status

# Re - authenticate if needed
gh auth logout && gh auth login

# Check NPM access
npm whoami

Windows - Specific

# Check PowerShell version (7+ recommended)
$PSVersionTable.PSVersion

# Test executable detection
where.exe gh
where.exe npm

Common Solutions

• No results? Try broader search terms.
• Private repos not found? Check gh auth status for organization membership.
• Windows issues? Install PowerShell 7+ for better security.
• Permission errors? Check executable permissions and PATH configuration.

🛡️ Security & Privacy

Local - First Architecture

• 🏠 100% Local - Runs entirely on your machine.
• 🚫 Zero Data Collection - No telemetry or data transmission.
• 🔑 Safe Authentication - Uses GitHub CLI OAuth, no personal tokens needed.

Enterprise Security

• 🛡️ Content Protection - Input validation and content sanitization.
• 🔐 Secret Detection - Automatic detection and redaction of sensitive data patterns.
• ⚪ Safe Commands Only - Pre - approved GitHub CLI and NPM commands only.

📚 For comprehensive security architecture details, see Technical Summary

💭 Background

This project started as a personal tool while working at Wix, born from the challenge of navigating large codebases and keeping up with rapidly evolving technology landscapes. What began as a side project evolved into the perfect code assistant that can help understand anything.

The goal is to make code exploration as intelligent as having a senior developer guide you through any codebase.

📄 License

This project is under the MIT License. See LICENSE for details.