Maxential Thinking MCP

🚀 MAXential Thinking MCP 服務器

MAXential Thinking MCP 服務器是一個模型上下文協議（MCP）服務器，為 AI 模型提供結構化推理工具。你可以將其想象成 思想的 git，能夠對推理鏈進行分支、修訂、合併和導航操作。

🚀 快速開始

AI 模型從結構化思維中受益匪淺。此服務器將這一過程外部化，使其具備以下特性：

• 透明性：不僅能看到結論，還能查看推理鏈。
• 可導航性：可以分支探索其他可能性、回溯和修訂。
• 可搜索性：能根據內容或標籤查找思想。
• 可導出性：可以將推理以 Markdown 或 JSON 格式分享。

✨ 主要特性

核心思維（v2.0）

分支功能（v2.0）

導航功能（v2.0）

組織功能（v2.2）

📦 安裝指南

Claude 桌面版

將以下內容添加到你的 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"]
    }
  }
}

從源代碼安裝

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

然後進行配置：

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

💻 使用示例

基礎用法

think: "用戶希望優化數據庫查詢"
think: "首先，我應該檢查是否存在 N+1 查詢問題"
think: "在用戶服務中發現了 3 個 N+1 問題"
tag: thoughtNumber=3, add=["發現", "數據庫"]
complete: "修復了 N+1 查詢，將加載時間減少了 40%"

分支探索替代方案

think: "我們應該使用 REST 還是 GraphQL？"
branch: branchId="rest-approach", reason="探索 REST"
think: "REST 更簡單，緩存效果更好"
switch_branch: branchId="main"
branch: branchId="graphql-approach", reason="探索 GraphQL"
think: "GraphQL 可減少過度獲取數據的問題"
merge_branch: branchId="rest-approach", strategy="總結"

搜索和導出

search: query="數據庫"           # 根據內容查找
search: tags=["決策"]          # 根據標籤查找
export: format="markdown"          # 以 Markdown 格式獲取完整推理鏈
visualize: format="mermaid"        # 獲取用於文檔的圖表

📚 詳細文檔

Mermaid 圖表（適用於 GitHub、Obsidian 等）

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

    subgraph alt-approach
        T2
    end

ASCII 圖表

思維鏈
==============

T1 --> T2 --> T3
從 T1 分支 [替代方案]

修訂記錄:
  T3 修訂 T1

日誌記錄

通過設置環境變量啟用文件日誌記錄：

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

開發

npm install          # 安裝依賴
npm run build        # 構建 TypeScript
npm run watch        # 開發模式下的監聽模式

📄 許可證

本項目採用 MIT 許可證。

貢獻

歡迎在 github.com/BAM-DevCrew/MAXential-Thinking-MCP 提交問題和拉取請求。