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 提交问题和拉取请求。