Branch Thinking

MCP tool to allow multiple chains of thought

typescript

44

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "m-siles-branch-thinking": {
      "command": "node",
      "args": [
        "/your-custom-mcp-dir-here/branch-thinking/dist/index.js"
      ]
    }
  }
}

Branch Thinking MCP Server lets you explore and manage multiple lines of thought in parallel. It supports creating and navigating branches, linking related thoughts, surfacing insights, and tracking which branches are most active or important. This makes it practical to organize complex reasoning, compare ideas across branches, and prioritize where you focus your attention.

How to use

You interact with the server through an MCP client that can manage multiple branches of thought. Use the core commands to switch between branches, view the history of points in each branch, and see cross-referenced thoughts. When you want deeper analysis, you can navigate focus and history to refine your line of thinking, and you’ll see automatic insights generated from key points in your thoughts. Use branch priorities to keep track of which branches deserve your attention based on confidence and interconnectedness.

Practical usage patterns you can employ:

Create a new branch to start an alternate train of thought and give it a clear identifier for easy navigation.
Use focus to quickly switch to the branch you want to develop or review.
Call history on a branch to review how ideas evolved over time.
Use cross references to link related thoughts across branches with typed relationships to reveal connections at a glance.
Rely on automatic insights to surface key conclusions or implications from your notes.
Monitor branch priority to know where to invest your effort next.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system so you can install dependencies and build the server.

Place the project in your custom MCP tool directory.
Install dependencies.

npm install

Build the server.

npm run build

Configure the MCP client to run the server. Use the following to point the MCP client at the local Node runtime and the built index.

"branch-thinking": {
  "command": "node",
  "args": [
    "/your-custom-mcp-dir-here/branch-thinking/dist/index.js"
  ]
}

Available tools

branch_management

Manage multiple branches of thought, create new branches, switch focus between branches, and track current branch status.

cross_references

Link related thoughts across branches with typed relationships to reveal connections and dependencies.

insights_generation

Automatically generate insights from key points in thoughts to surface conclusions and implications.

priority_tracking

Monitor branch priorities based on confidence and connections to guide where you focus next.