使用说明（Markdown 格式）

MAXential Thinking MCP 服务器

简要介绍

• 这是一个基于 MCP 的后端服务器实现，用于向大模型（LLM）客户端提供结构化的“思维链”上下文与工具执行能力。服务器管理思想历史、分支、标签、导出与可视化等功能，默认通过标准输入输出（STDIO）与客户端进行通信。

主要功能点

• 思维工具集（Think/Revise/Complete）：添加思考步骤、修订历史、结论完成标记。
• 分支管理（Branch/Switch Branch/List Branches/Get Branch/Close Branch/Merge Branch）：实现分支创建、切换、查看与合并等能力，支持从主干派生分支并回归主线。
• 导航与查询（Get Thought/Get History）：按编号获取具体思考、按条件查看历史记录。
• 组织与检索（Tag/Search/Export/Visualize）：给思考打标签、按内容或标签搜索、导出为 Markdown/JSON、生成 ASCII 或 Mermaid 图示。
• 会话与日志：会话状态、可选日志文件输出。
• 传输与协议：通过 MCP 的 JSON-RPC 接口暴露工具集，并使用 STDIO 传输与客户端对接（未来可扩展到其他传输）。

安装步骤

• 克隆仓库并安装依赖：
  • 克隆并进入项目目录
  • 运行 npm install
  • 运行 npm run build，将 TypeScript 编译为可运行的 JavaScript（dist 目录）

服务器配置与启动

• MCP 客户端需要配置一个服务器条目，指明启动命令及参数，以便建立与 MCP 服务器的连接。该实现使用 STDIO 传输方式启动与通信，因此客户端需要能够启动该服务器进程并通过标准输入输出建立连接。
• 启动方式（示意性描述，实际路径以你本地构建输出为准）：
  • 使用 Node 直接运行编译产物，例如 dist/src/index.js
  • 运行后，服务器会在标准输入/输出上与客户端对话，日志会输出到标准错误，若设置了 MAXENTIAL_LOG_FILE，则日志亦会写入该文件

服务器配置（MCP 客户端需要的配置信息，JSON 结构描述）

• 配置目标：指定服务器名称、启动命令及参数，以便客户端可以通过 MCP 连接并使用服务器功能。
• 配置要点：
  • server name：maxential-thinking
  • command：node
  • args：指向编译产物的入口，例如 /path/to/your/project/dist/src/index.js
• 配置示例描述（JSON 结构描述，不以代码块呈现）： mcpServers: { "maxential-thinking": { "command": "node", "args": ["/path/to/your/project/dist/src/index.js"] } } 说明：在实际使用中，请将 /path/to/your/project/dist/src/index.js 替换为你本地构建产物的实际路径。该配置仅用于 MCP 客户端启动时对接服务器，不是服务器端的源码配置。

基本使用方法

• 运行服务器后，客户端通过 MCP 协议向服务器发送请求，服务器返回 Tool 列表及 Tool 调用结果。
• 常用流程：
  • 读取工具列表以了解可用工具
  • 调用 think/revise/complete 等工具推进思维链
  • 使用 branch 系列工具管理分支，使用 get_history/get_thought 进行回溯和导航
  • 使用 export/visualize 将思维链导出或可视化
• 服务器默认通过 STDIO 与客户端通信，适配本地开发和与支持 MCP 的客户端集成。

注意事项

• 服务器实现包含了日志机制，若设置环境变量 MAXENTIAL_LOG_FILE，可将日志输出写入指定文件。
• 构建产物路径必须与启动命令中的入口路径一致，否则客户端无法正确启动与连接。
• 该实现当前以 STDIO 传输为主，可在后续扩展以支持其他传输协议（如 SSE、WebSocket）。

操作要点

• 安装与打包完成后，请确保客户端能够正确定位 dist/src/index.js，并以 Node 运行以便与 MCP 客户端建立连接。
• 测试前，请先确认环境变量（如是否禁用思考日志）和输出路径设置符合你的需求。

总之，该仓库提供了一个可运行的 MCP 服务器实现，具备核心工具、分支导航、历史导航、导出与可视化等功能，符合 MCP 服务器的基本要求。