使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在帮助大型语言模型 (LLM) 进行结构化思维。它允许 LLM 以程序化的方式构建思维导图来探索想法空间，并强制进行“元认知”自我反思。该服务器通过定义和管理思维 (Thoughts) 的生命周期，提供工具来捕获、修订、检索和总结 LLM 的思考过程，从而增强 LLM 的推理和问题解决能力。

主要功能点

结构化思维: 支持 LLM 通过定义不同的思考阶段（如问题定义、分析、构思等）来组织和管理思考过程。
思维导图构建: 允许 LLM 创建和探索思维分支，并行处理多个思路，并管理复杂的想法空间。
元认知反馈: 根据 LLM 提供的思维质量评分和思考阶段，提供元认知反馈，引导 LLM 改进思考策略。
短期和长期记忆: 维护 LLM 最近的思维记录（短期记忆）以及可检索的历史思维记录（长期记忆），用于过程回顾和总结。
工具集成: 提供一系列 MCP 工具，如 'capture_thought'（捕获思维）、'revise_thought'（修订思维）、'retrieve_relevant_thoughts'（检索相关思维）、'get_thinking_summary'（获取思维总结）和 'clear_thinking_history'（清除思维历史），支持与 MCP 客户端的交互。

安装步骤

克隆仓库

git clone https://github.com/Promptly-Technologies-LLC/mcp-structured-thinking.git
cd mcp-structured-thinking

安装依赖 确保你已经安装了 Node.js 和 npm。然后运行以下命令安装项目依赖：
```
npm install
```
构建项目 运行以下命令构建 TypeScript 项目：
```
npm run build
```
构建成功后，将在 'dist' 目录下生成可执行的 JavaScript 文件。

服务器配置

为了让 MCP 客户端（如 Claude Desktop 或 Cursor）连接到此 MCP 服务器，你需要配置客户端的工具设置。以下是一个 JSON 配置示例，你需要将其添加到你的 MCP 客户端的工具配置中：

{
  "structured-thinking": { // server name，客户端用这个名字来识别和调用该服务器
    "command": "npx",    // 启动服务器的命令，这里使用 npx 来运行本地安装的 structured-thinking 包
    "args": ["-y", "structured-thinking"] // 命令参数，-y 自动确认安装 structured-thinking 包，structured-thinking 是 package.json 中 bin 定义的可执行文件名
  }
}

配置参数说明:

'structured-thinking': 服务器名称，在 MCP 客户端中用于标识和调用此服务器。
'command': 启动服务器的命令。 'npx' 通常用于运行本地安装的 npm 包的可执行文件。
'args': 传递给 'command' 的参数。 '["-y", "structured-thinking"]' 表示使用 'npx' 运行 'structured-thinking' 命令，'-y' 参数用于自动确认安装可能需要的包。'structured-thinking' 是在 'package.json' 中 'bin' 字段定义的可执行文件名，npm install 后会在 'node_modules/.bin' 目录下创建指向 'dist/index.js' 的符号链接。

基本使用方法

启动服务器: 当 MCP 客户端尝试连接或调用 'structured-thinking' 服务器时，客户端会根据配置自动启动服务器进程。你无需手动启动服务器。

在 MCP 客户端中使用工具: 在支持 MCP 协议的客户端中（例如 Claude Desktop, Cursor），你可以使用配置中定义的服务器名称 '"structured-thinking"' 来调用服务器提供的工具。

例如，要使用 'capture_thought' 工具捕获一个思维，你可以在客户端中发送如下格式的请求（具体发送方式取决于客户端的界面或 API）：

{
  "tool_call": {
    "tool_name": "structured-thinking.capture_thought", // 注意工具名称的格式：serverName.toolName
    "parameters": {
      "thought": "我需要解决一个复杂的问题。",
      "thought_number": 1,
      "total_thoughts": 5,
      "next_thought_needed": true,
      "stage": "Problem Definition"
      // ... 其他 capture_thought 工具的参数
    }
  }
}

客户端会将请求通过 JSON-RPC 协议发送到 'structured-thinking' 服务器，服务器处理请求后返回 JSON-RPC 响应。你可以使用其他工具如 'get_thinking_summary' 来获取思考过程的总结，或使用 'revise_thought' 来修订之前的思维。

注意: 此服务器主要用于与 MCP 客户端集成，直接用户界面较少。用户通常通过 MCP 客户端与服务器进行交互，利用服务器提供的结构化思维和元认知能力来辅助 LLM 的应用。

关键词