octocode

Octocode MCP Server provides an AI-enabled coding assistant that connects your AI agent to code repositories and local tooling. It exposes capabilities for deep code exploration via LSP, GitHub and GitLab integration (search repositories, identify usage patterns, read implementations, explore PRs), and local workspace navigation (search code, browse directories, locate files) with semantic navigation. The server is designed to empower an AI assistant with research-driven skills, enabling workflows like evidence-based exploration, plan-driven execution, and PR review across multiple domains. Once running, you can invoke its skills to perform tasks such as researching code bases, performing local searches, planning implementations, and reviewing PRs with structured, evidence-backed output. The server’s design emphasizes integration with existing tooling (GitHub/GitLab, LSP, local file systems) and a suite of skills to extend agent capabilities, including Research, Local Search, Plan, PR Reviewer, Roast, Prompt Optimizer, and Documentation Writer.

Prerequisites:

• Node.js (preferred 18.x or newer) and npm installed on your system
• GitHub authentication (for seamless access to private repos and the authentication setup described in the docs)

Installation steps:

1. Verify Node.js and npm are installed

node -v
npm -v

2. Run the Octocode MCP server via npx (recommended via Octocode CLI)

npx octocode-cli

3. Alternative: manually configure the MCP server in your MCP config

{
  "mcpServers": {
    "octocode": {
      "command": "npx",
      "args": ["octocode-mcp@latest"]
    }
  }
}

4. If you want to install a specific skill directly (example for Research):

npx add-skill https://github.com/bgauryy/octocode-mcp/tree/main/skills/octocode-research

5. Start interacting with the server via your MCP host tooling as described in the documentation references.

• The MCP server relies on GitHub authentication for full access to repositories and advanced discovery features; ensure authentication setup is completed as per the Authentication Setup guide.
• You can install and use the server through the recommended Octocode CLI (npx octocode-cli) for an interactive setup experience that handles OAuth, MCP server installation, and a skills marketplace.
• If you’re using the manual configuration approach, keep your MCP’s global configuration in sync with the octocode entry to ensure the server boots with the correct command and arguments.
• The npm package name for this server (when using npx) is octocode-mcp; you can reference it in automation scripts as the package to install or run.
• For local testing, you can combine the Octocode MCP server with Local Tools + LSP Reference and Skills guides to understand how each capability is exposed to your AI agent.
• If you encounter issues with license, authentication, or API quotas, consult the Troubleshooting and Documentation sections of the repository.