About bgauryy/octocode-mcp
bgauryy/octocode-mcp is an MCP server published by bgauryy in the Data category: mCP server for semantic code research and context generation on real-time using LLM patterns | Search naturally across public & private repos based on your permissions | Transform any accessible codebase/s into AI-optimized knowledge on simple and complex flows | Find real implementations and live d. It has been installed 0 times through Conduid.
The repository has 741 stars and 57 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.
Install
npx octocode-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about bgauryy/octocode-mcp
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
Octocode: Research Driven Development for AI
Installation
Prerequisites: GitHub authentication required. See Authentication Setup.
Recommended: Octocode CLI
npx octocode-cli install
Interactive 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-research
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 |
|---|---|
| Researcher | Code search & exploration — local LSP + external (GitHub, npm/PyPI) |
| Research | Multi-phase research with sessions, checkpoints, state persistence |
| Engineer | Understand, write, analyze, audit code — AST + LSP + dependency graph |
| Plan | Evidence-based planning: Understand > Research > Plan > Implement |
| RFC Generator | Formal technical decisions with alternatives, trade-offs, and recommendations |
| PR Reviewer | PR & local code review across 7 domains with LSP flow tracing |
| Roast | Brutal code critique with file:line citations and severity levels |
| Prompt Optimizer | Turn weak prompts into enforceable agent protocols |
| Doc Writer | 6-phase pipeline producing 16+ validated docs |
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:
- Authentication Setup
- Configuration Reference
- Local Tools + LSP Reference
- CLI Skills Guide
- Skills Index
- Troubleshooting
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.
README mirrored from the source repository 9 hours ago. The original is authoritative.