Octocode MCP
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-cli installInteractive setup wizard with GitHub OAuth, MCP server installation, and skills marketplace. Pass --ide <ide> for non-interactive install (e.g. npx octocode-cli install --ide cursor).
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 & Bitbucket: Search repositories, find usage patterns, read implementations, explore PRs/MRs
Local Tools: Search code (ripgrep), browse directories, find files in your local codebase
LSP Intelligence: Go to Definition, Find References, Call Hierarchy — compiler-level understanding
Package Discovery: Resolve npm/PyPI packages to their source repos
https://github.com/user-attachments/assets/de8d14c0-2ead-46ed-895e-09144c9b5071
Packages
This is a yarn-workspaces monorepo. Each package has its own README.md; all setup/reference docs live in docs/, and all AI agent guidance lives in the root AGENTS.md.
Package | Purpose |
MCP server — 14 tools across GitHub/GitLab/Bitbucket, local FS, LSP | |
CLI — installer, tool runner, skills marketplace | |
VS Code extension — GitHub OAuth + multi-editor MCP install | |
Shared utilities — credentials, session, platform | |
Standalone security utilities |
Skills
Agent Skills are a lightweight, open format for extending AI agent capabilities. Skills index: skills/README.md
Research & Code Analysis
Skill | What it does |
Code search & exploration — local LSP + external (GitHub, npm/PyPI) | |
Multi-phase research with sessions, checkpoints, state persistence | |
Understand, write, analyze, audit code — AST + LSP + dependency graph | |
Idea validation grounded in evidence — GitHub, npm/PyPI, web in parallel | |
What's new in AI, dev tools, web platform, security, notable repos |
Planning & Writing
Skill | What it does |
Evidence-based planning: Understand > Research > Plan > Implement | |
Formal technical decisions with alternatives, trade-offs, and recommendations | |
6-phase pipeline producing 16+ validated docs | |
Turn weak prompts into enforceable agent protocols | |
Thinking framework for designing/reviewing MCP & multi-agent workflows |
Review & Critique
Skill | What it does |
PR & local code review across 7 domains with LSP flow tracing | |
Brutal code critique with file:line citations and severity levels |
Build & Output
Skill | What it does |
Polished multi-file HTML presentations via 6-phase design flow | |
Dynamic DESIGN.md generator covering visual language, components, a11y | |
CDP-level browser debugging: network, console, perf, DOM, screenshots |
Tooling & Setup
Skill | What it does |
Interactive step-by-step Octocode installer for macOS and Windows | |
Run Octocode MCP tools from the terminal without wiring MCP | |
Find, evaluate, install, refactor Agent Skills (SKILL.md format) | |
Local HTML dashboard from Octocode MCP usage stats |
https://github.com/user-attachments/assets/5b630763-2dee-4c2d-b5c1-6335396723ec
Documentation
Full index: docs/README.md. All monorepo documentation lives in docs/ — no per-package docs/.
Docs map
docs/configuration/— install, auth providers, MCP clients, env/config, troubleshootingdocs/dev/— tool/API references, workflows, architecture, contributing, skillsdocs/specs/— design specs and RFCs
Setup
Tool References
CLI & Skills
Shared Internals
Operations
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.
Maintenance
Appeared in Searches
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/bgauryy/octocode'
If you have feedback or need assistance with the MCP directory API, please join our Discord server