Octocode MCP is an AI-optimized code assistant for advanced GitHub and npm/PyPI ecosystem exploration and analysis.
GitHub Repository Discovery & Analysis: Search and analyze repositories (including private ones) by topics, languages, stars, activity, and explore their detailed structures
Code Search & Content Retrieval: Perform semantic code searches and fetch file contents with token optimization and fallback handling
Project History & Collaboration Research: Analyze commits (with diffs), issues, and pull requests to understand project evolution and team collaboration
Package Ecosystem Intelligence: Search and retrieve comprehensive metadata across npm and PyPI packages for dependency analysis and discovery
AI Context Generation: Extract token-efficient context from diverse code resources to enhance AI capabilities for code analysis and documentation
Enterprise & Security: Support private organizations with production-ready security features like secret detection and content sanitization
API Status Verification: Check GitHub/npm connections, organizations, and access permissions
Integration for supporting the developer through the Buy Me a Coffee platform
Provides deep search and discovery across GitHub repositories, enabling access to code, issues, pull requests, and commit histories from both public and private repositories while respecting organizational permissions
Provides specialized search capabilities for Next.js applications, particularly for finding authentication patterns and implementation examples
Enables package discovery and analysis in the Node.js ecosystem, with capabilities to research metadata, dependencies, and repository connections
Allows exploration of Python packages with cross-ecosystem comparison capabilities
Offers targeted research into React's implementation details, including specific features like concurrent rendering
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Octocode MCPfind popular React component libraries with TypeScript support"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Octocode: Research Driven Development for AI
Installation
Prerequisites: GitHub authentication required. See Authentication Setup.
Recommended: Octocode CLI
npx octocode-cliInteractive setup wizard with GitHub OAuth, MCP server installation, and skills marketplace.
Alternative Methods
Add to your MCP configuration file:
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": ["octocode-mcp@latest"]
}
}
}npx add-skill https://github.com/bgauryy/octocode-mcp/tree/main/skills/octocode-researchRelated MCP server: GitHub Enterprise MCP Server
MCP Server
The Octocode MCP Server connects your AI assistant to code:
GitHub & GitLab: Search repositories, find usage patterns, read implementations, explore PRs
Local Tools: Search code, browse directories, find files in your local codebase
LSP Intelligence: Go to Definition, Find References, Call Hierarchy -- compiler-level understanding
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 |
Deep code exploration via LSP, local tools, GitHub API, packages, PRs | |
Fast local codebase exploration with LSP semantic navigation | |
Evidence-based planning: Understand, Research, Plan, Implement | |
PR review across 7 domains with evidence-backed findings | |
Brutally honest code critique with file:line citations | |
Transform weak prompts into enforceable agent protocols | |
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.