Octocode MCP

Transform Any AI Assistant Into a Code Research Expert

Octocode MCP gives AI assistants real-time access to millions of GitHub repositories, enabling them to provide context-rich, production-quality responses based on real-world code implementations.

Perfect for: Code creation, bug fixes, architecture research, documentation, and learning from real implementations.

📖 Full Documentation →

# 1. Authenticate with GitHub (requires GitHub CLI: https://cli.github.com/)
gh auth login

# 2. Add to your AI assistant's config
{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": ["octocode-mcp@latest"]
    }
  }
}

# 3. Start using it!
"Search for React hooks implementations in popular repositories"

📖 Complete Setup Guide →

This repository contains three main components:

packages/octocode-mcp/

The core MCP server that enables AI assistants to search and analyze GitHub code.

Features:

• 🔍 Smart code discovery across millions of repositories
• 📊 Progressive research workflows
• 🔒 Enterprise-grade security with content sanitization
• ⚡ Token-efficient responses (up to 70% reduction)

📖 Full Documentation →

packages/octocode-utils/

Utility library for token optimization and content processing used by Octocode MCP.

Features:

• 🗜️ Smart content minification for 50+ file types
• ⚡ Advanced token optimization strategies
• 🔧 Helper utilities for content processing
• 📦 Standalone NPM package

Perfect for: Building token-efficient AI tools and content processors.

packages/octocode-local-memory/

Ultra-fast in-memory storage MCP server for AI agent coordination and communication.

Features:

• ⚡ Sub-millisecond operations (< 1ms read/write)
• 🤝 Enable multiple AI agents to coordinate during workflows
• 🔒 File lock management to prevent conflicts
• 📊 Task assignments, status updates, and inter-agent messaging
• 🪶 Zero configuration - no database or Redis required

Perfect for: Multi-agent workflows, task coordination, real-time status tracking, and parallel agent execution.

📖 Full Documentation →

octocode-claude-plugin/

Multi-agent development system for Claude Code that transforms ideas into production-ready applications.

Features:

• 7 specialized AI agents (Product Manager, Architect, Engineers, QA)
• 7-phase workflow from requirements to deployment
• Research-driven decisions from 100k+ GitHub repos
• Parallel execution with file conflict prevention
• 80-90% test coverage enforcement

Example:

/octocode-generate Build a blog platform with authentication and comments

📖 Full Documentation →

See the dramatic difference between generic AI and Octocode-enhanced AI.

• Deep code research (React internals)
• AI agent development workflow
• Pull request analysis

• 🌐 Official Website - Interactive tutorials
• 📖 Usage Guide - 20+ examples
• 🔐 Authentication - Setup guide
• 🔧 API Reference - Tool schemas
• 📚 Code Resources - 610+ curated repositories

• ⭐ Star us on GitHub
• 💬 Discussions
• 🐛 Report Issues

---

Built with ❤️ for developers by developers

Website • GitHub • NPM