🎯 What is Octocode?
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.
🚀 Quick Start
# 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"
📦 Repository Contents
This repository contains three main components:
🔍 Octocode MCP Server
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)
🧰 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.
🤖 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
🎥 See It In Action
🎯 Live Demo: ThreeJS Implementation Comparison
See the dramatic difference between generic AI and Octocode-enhanced AI.
📺 YouTube Examples
- Deep code research (React internals)
- AI agent development workflow
- Pull request analysis
📚 Resources
- 🌐 Official Website - Interactive tutorials
- 📖 Usage Guide - 20+ examples
- 🔐 Authentication - Setup guide
- 🔧 API Reference - Tool schemas
- 📚 Code Resources - 610+ curated repositories
🌟 Community
- ⭐ Star us on GitHub
- 💬 Discussions
- 🐛 Report Issues
# Octocode MCP
Transform Any AI Assistant Into a Code Research Expert