bgauryy/octocode-mcp

Overview

MCP server that performs semantic code research and generates context using LLM patterns. It allows searching across public and private repositories based on user permissions. It transforms accessible codebases into AI-optimized knowledge for finding real implementations and documentation.

Best for

Best for
Developers who need to search and understand codebases across repositories using natural language queries.

Use cases

• Searching across private repos for code patterns
• Generating context for complex code flows
• Finding real implementations and live docs across repositories

How to use

Install

npx octocode --help

Tools exposed

• OCTOCODE_HOME
• GITHUB_API_URL
• ENABLE_LOCAL
• ENABLE_CLONE
• WORKSPACE_ROOT
• ALLOWED_PATHS
• REQUEST_TIMEOUT
• MAX_RETRIES
• OCTOCODE_OUTPUT_FORMAT

Tested with

Claude Code, Cursor, Windsurf, VS Code, ChatGPT

Notes

MCP server that performs semantic code research and generates context using LLM patterns. It allows searching across public and private repositories based on user permissions. It transforms accessible codebases into AI-optimized knowledge for finding real implementations and documentation.

854 stars on GitHub. Last updated 2026-05-23. Licensed MIT.

Use cases

• Searching across private repos for code patterns
• Generating context for complex code flows
• Finding real implementations and live docs across repositories

Pros

• Supports both public and private repos based on permissions
• Uses LLM patterns for semantic understanding
• Transforms codebases into AI-optimized knowledge

Cons

• Dependency on LLM patterns may introduce variability
• Requires appropriate permissions for private repos
• Focused on code research, not general development tasks

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.