Octocode

Community

bgauryy

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 docs from anywhere

Publisher	bgauryy
Repository	`octocode-mcp`
Language	TypeScript
Forks	69
Stars	815
Available tools	6
Transport type	stdio
Categories	AI Ml Developer Tools
License	MIT
Links	GitHub Homepage

Connect tools to AI workflows
Octocode exposes MCP capabilities that can be used by compatible AI clients and agents.
6 available tools
Browse the callable actions below, including names and descriptions when provided by the server.
Ready-to-copy setup
Use the installation snippets to configure this server in your preferred MCP client.
Open source signals
815 stars and 69 forks from the linked repository.

Octocode: Research Driven Development for AI

Installation

Prerequisites: GitHub authentication required. See Authentication Setup.

Recommended: Octocode CLI

bash
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:

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

bash
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

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.

Installation

TypingMind

Prerequisites:

Node.js 18+

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

Available Tools

githubSearchCode
$2e
githubGetFileContent
$2f
githubViewRepoStructure
$30
githubSearchRepositories
$31
githubSearchPullRequests
Search or fetch Pull Requests (metadata, diffs, discussions)
packageSearch
$32

Use Octocode MCP with multiple AI models

TypingMind connects MCP tools at the workspace level, so once Octocode is connected, you can use it with different AI models in TypingMind instead of setting it up separately for each model. This MCP runs locally through the TypingMind MCP connector on your device.

Setup guide to use the local connector

Use this when the MCP server needs access to local files, apps, or private resources on your computer.

Open the MCP settings

In TypingMind, go to Settings, Advanced Settings, then Model Context Protocol and choose Setup Connector.

Open TypingMind in your browser.
Click the Settings icon.
Go to Advanced Settings.
Open the Model Context Protocol section.
Click Setup Connector and choose This Device.

TypingMind MCP connector setup screen with This Device selected

Run the connector command

Choose This Device, copy the command from TypingMind, and run it in Terminal. Keep the process running while you use MCP.

Copy the setup command shown by TypingMind.
Open Terminal on macOS or Windows Terminal on Windows.
Paste and run the command.
Approve the package install if Terminal asks you to proceed.
Keep the Terminal window running while using MCP tools.

Add Octocode as a server

When the connector status is Ready, click Edit Servers and paste the MCP server configuration.

Wait until the connector status shows Ready.
Click Edit Servers.
Paste the Octocode MCP server configuration.
Save the server list.
Refresh if you want to confirm the connector is still ready.

TypingMind MCP settings showing active server and Edit Servers button

Use it across models

Save the server list, open Plugins, enable the Octocode MCP tools, then select any supported AI model in TypingMind and use the tools in chat or assign them to an AI agent.

Open the Plugins page in TypingMind.
Enable the Octocode MCP tools.
Start a chat and choose the AI model you want to use.
Use the MCP tools in chat or assign them to an AI agent.
Switch to another AI model whenever needed without reconnecting MCP.

TypingMind chat using enabled MCP tools with a selected AI model

Frequently asked questions

What is the Octocode MCP server used for?

Octocode is an MCP server that lets compatible AI clients connect to external tools and context. In TypingMind, you can add this MCP server once and make its tools available in your AI workspace.

Can I use Octocode MCP with multiple AI models in TypingMind?

Yes. TypingMind connects MCP tools at the workspace level, so you can use Octocode with different AI models such as Claude, ChatGPT, Gemini, or other models you have configured in TypingMind without setting up the MCP server separately for each model.

Why use Octocode MCP with TypingMind?

TypingMind is one of the best frontends for LLM chat because it brings multiple AI models, prompts, plugins, AI agents, API keys, and MCP tools into one workspace. With Octocode connected, you can use its MCP tools across your preferred models while keeping your chat workflow organized in TypingMind.

How do I connect Octocode MCP to TypingMind?

Octocode runs through the TypingMind local MCP connector. This is best when the MCP server needs access to local files, desktop apps, command-line tools, or private resources on your computer.

What tools does Octocode MCP provide in TypingMind?

Octocode exposes 6 MCP tools that can be enabled from the TypingMind Plugins page and used in chat or assigned to AI agents.

Do I need to share my API keys with TypingMind to use Octocode MCP?

No. TypingMind is local-first and lets you keep your model providers, API keys, prompts, and MCP configuration under your control. If Octocode requires authentication, add the required headers, OAuth settings, or local configuration for that MCP server when you create the connection.

Related MCP Servers

View all

Knowledge Graph Memory

modelcontextprotocol

OrganizationPopular

Model Context Protocol Servers

Context7

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

Blender

Experience seamless AI-powered 3D modeling by connecting Blender with Claude AI via the Model Context Protocol. BlenderMCP enables two-way communication, allowing you to create, modify, and inspect 3D scenes directly through AI prompts. Control objects, materials, lighting, and execute Python code in Blender effortlessly. Access assets from Poly Haven and generate AI-driven models using Hyper3D Rodin. This integration enhances creative workflows by combining Blender’s robust tools with Claude’s intelligent guidance, making 3D content creation faster, interactive, and more intuitive. Perfect for artists and developers seeking AI-assisted 3D design within Blender’s environment.

Google GenAI Toolbox

MCP Toolbox for Databases is an open source MCP server for databases.

Octocode: Research Driven Development for AI

Installation

Recommended: Octocode CLI

Alternative Methods

MCP Server

Skills

Documentation

The Manifest

Contributing

Installation

Available Tools

Search or fetch Pull Requests (metadata, diffs, discussions)

Use Octocode MCP with multiple AI models

Setup guide to use the local connector

Open the MCP settings

Run the connector command

Add Octocode as a server

Use it across models

Frequently asked questions

Related MCP Servers

Set up your own AI workspace now