Maxential Thinking MCP

🚀 MAXential Thinking MCP Server

A Model Context Protocol (MCP) server that provides structured reasoning tools for AI models. It can be regarded as git for thoughts, enabling you to branch, revise, merge, and navigate your reasoning chains.

🚀 Quick Start

The MAXential Thinking MCP Server is a powerful tool that offers structured reasoning capabilities for AI models. It externalizes the structured thinking process, bringing multiple benefits to AI models.

✨ Features

Core Thinking (v2.0)

Branching (v2.0)

Navigation (v2.0)

Organization (v2.2)

📦 Installation

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "npx",
      "args": ["-y", "@bam-devcrew/maxential-thinking-mcp"]
    }
  }
}

From Source

git clone https://github.com/BAM-DevCrew/MAXential-Thinking-MCP.git
cd MAXential-Thinking-MCP
npm install
npm run build

Then configure:

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "node",
      "args": ["/path/to/MAXential-Thinking-MCP/dist/src/index.js"]
    }
  }
}

💻 Usage Examples

Basic Usage

think: "The user wants to optimize database queries"
think: "First, I should check for N+1 query problems"
think: "Found 3 N+1 issues in the user service"
tag: thoughtNumber=3, add=["finding", "database"]
complete: "Fixed N+1 queries, reduced load time by 40%"

Advanced Usage

think: "Should we use REST or GraphQL?"
branch: branchId="rest-approach", reason="Exploring REST"
think: "REST is simpler, better caching"
switch_branch: branchId="main"
branch: branchId="graphql-approach", reason="Exploring GraphQL"
think: "GraphQL reduces overfetching"
merge_branch: branchId="rest-approach", strategy="summary"

Search and Export

search: query="database"           # Find by content
search: tags=["decision"]          # Find by tag
export: format="markdown"          # Get full chain as markdown
visualize: format="mermaid"        # Get diagram for docs

📚 Documentation

Visualization Output

Mermaid (for GitHub, Obsidian, etc.)

graph TD
    T1["#1"] --> T2["#2"]
    T1 --> T3["#3"]
    T3 -.revises.-> T1

    subgraph alt-approach
        T2
    end

ASCII

Thinking Chain
==============

T1 --> T2 --> T3
Branch [alt-approach] from T1

Revisions:
  T3 revises T1

Logging

Enable file logging by setting environment variable:

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "node",
      "args": ["/path/to/dist/src/index.js"],
      "env": {
        "MAXENTIAL_LOG_FILE": "/path/to/error.log"
      }
    }
  }
}

Development

npm install          # Install dependencies
npm run build        # Build TypeScript
npm run watch        # Watch mode for development

📄 License

This project is licensed under the MIT License.

🔗 Contributing

Issues and PRs are welcome at github.com/BAM-DevCrew/MAXential-Thinking-MCP