Sequential Thinking MCP Server

顺序思考 MCP 服务

一种 MCP 服务实现，提供一项工具，通过结构化思考流程动态、反思性地解决问题，并自动将每个思考会话的顺序思考日志写入 Recall。

功能

Sequential Thinking MCP 提供以下功能：

• 逐步解决问题

  • 将复杂问题分解为易于处理的步骤
  • 随着理解加深，修订并完善思路
  • 分支出其他推理路径
  • 动态调整思考总数

• 假设管理

  • 生成解决方案假设
  • 根据思维链验证假设
  • 必要时提供纠正性分析

• Recall 集成

  • 在链上安全存储所有顺序思考会话
  • 访问完整的思考历史记录
  • 检索特定思考会话
  • 列出所有已存储的会话

安全 ⚠️

重要：保护私钥

此 MCP 服务需要私钥才能执行 Recall 操作。为保护这一敏感信息：

1. 切勿分享私钥或 .env 文件内容
2. 切勿运行会显示私钥的命令（例如 cat .env）
3. 未经你批准，切勿允许大模型直接执行 shell 命令
4. 如果使用 .env 文件，请将其权限设为受限：chmod 600 .env

多层保护

此服务实现了多层安全防护，以确保私钥安全：

1. 私钥隔离

• 仅在初始化期间加载私钥
• 加载后立即从环境变量中移除密钥
• 实际密钥绝不会记录日志或传输给大模型

2. 日志保护

• 自动删去日志中任何符合私钥格式的内容
• 过滤控制台输出，将私钥替换为 [REDACTED]
• 显示前对对象进行清理，屏蔽敏感字段

3. 防止访问

• 安全处理环境变量
• 严格验证必需的环境变量
• 清理控制台输出，防止泄露机密

Recall 集成

此 MCP 服务集成了 Recall，支持在链上安全存储顺序思考日志。每个查询的所有思考步骤都会自动保存到你的 Recall 存储桶中。

配置

要使用 Recall 集成，你需要提供以下环境变量：

• RECALL_PRIVATE_KEY（必需）：你的 Recall 私钥
• RECALL_NETWORK（可选）：要连接的网络（testnet 或 mainnet，默认为 testnet）
• RECALL_BUCKET_ALIAS（可选）：存储日志的存储桶别名（默认为 'sequential-thinking-logs'）
• RECALL_LOG_PREFIX（可选）：存储桶中日志文件的前缀（默认为 'sequential-'）

每个思考都会单独存储，并附带其元数据；思考结束后，则会存储完整的思考会话。这使你能够：

• 查看完整的推理链
• 分析思考过程
• 保存有价值的问题解决方法，以供日后参考
• 构建推理模式知识库

环境变量优先级

Sequential Thinking MCP 服务按以下顺序确定环境变量的优先级：

1. 直接从 Cursor/Claude 配置中提供的环境变量
2. .env 文件中的环境变量（若存在且 #1 不可用）
3. 可选变量的默认值

设置

1. 克隆仓库

2. 安装依赖项：

   npm install
   

3. 选择以下配置方法之一：

   方法 1：在 Cursor/Claude 配置中使用环境变量（推荐）

   推荐的做法是在 Cursor 或 Claude Desktop 配置中直接提供环境变量。这样更加安全，也无需使用 .env 文件。

   • 通过配置提供环境变量时，服务会自动使用这些变量。
   • 具体设置说明请参阅下方的“添加到 Cursor”和“添加到 Claude Desktop”部分。

   方法 2：使用 .env 文件（备用）

   如果你更愿意使用 .env 文件，或者不通过 Cursor/Claude 直接运行服务，可以创建一个：

   1. 创建 .env 文件并填入私钥：

      RECALL_PRIVATE_KEY=your_private_key_here
      RECALL_NETWORK=testnet
      RECALL_BUCKET_ALIAS=sequential-thinking-logs
      RECALL_LOG_PREFIX=sequential-
      

   2. 确保 .env 文件的安全：

      chmod 600 .env
      

   注意：私钥可以带有或不带有“0x”前缀，两种格式均可使用。

工具

该服务提供以下 MCP 工具：

工具名称	描述	参数
sequentialthinking	逐步处理思考过程并将其存储在 Recall 中	thought：字符串，nextThoughtNeeded：布尔值，thoughtNumber：整数，totalThoughts：整数，以及可选参数
recallstatus	获取 Recall 集成的状态	check：布尔值
listsessions	列出所有顺序思考会话	includePortalLinks?：布尔值
getsession	获取指定的思考会话	key：字符串

sequentialthinking

支持以详细、循序渐进的方式进行思考，以解决问题并开展分析。

输入：

• thought（字符串）：当前思考步骤
• nextThoughtNeeded（布尔值）：是否需要继续思考
• thoughtNumber（整数）：当前思考步骤编号
• totalThoughts（整数）：预计所需的思考步骤总数
• isRevision（布尔值，可选）：是否在修订之前的思考
• revisesThought（整数，可选）：正在重新考虑的思考步骤编号
• branchFromThought（整数，可选）：分支起始思考步骤编号
• branchId（字符串，可选）：分支标识符
• needsMoreThoughts（布尔值，可选）：是否需要更多思考

输出： 提交最终思考步骤时（nextThoughtNeeded = false），该工具会返回：

• recallInfo，其中包含：
  • txHash：Recall 网络上的交易哈希
  • success：存储是否成功
  • key：会话文件名
  • viewUrl：用于在 Recall 门户中查看会话的直接链接

recallstatus

获取 Recall 集成的状态。

输入：

• check（布尔值）：设为 true 以检查状态

输出：

• Recall 集成的相关信息，包括初始化状态、存储桶地址、存储桶别名和日志前缀

listsessions

列出存储在 Recall 存储桶中的所有顺序思考会话对象。

输入：

• includePortalLinks（布尔值，可选）：是否为每个会话附带门户链接

输出：

• 所有已存储会话文件的列表，包含其元数据和可选的门户链接

getsession

检索指定顺序思考会话文件的内容。

输入：

• key（字符串）：要检索的会话键/文件名

输出：

• 所请求会话文件的完整内容，包括所有思考内容和元数据
• 用于在 Recall 门户中查看会话的链接

用法

Sequential Thinking 工具适用于：

• 将复杂问题分解为多个步骤
• 为计划和设计留出修改空间
• 可能需要调整方向的分析
• 初始时可能无法明确完整范围的问题
• 需要在多个步骤中保持上下文的任务
• 需要过滤无关信息的情况

构建

npm run build
npm run start

开发模式

npm run dev

开发重要说明

开发 MCP 服务时，请使用 console.error() 而不是 console.log() 进行所有调试和日志记录。Claude Desktop 应用通过 stdout 与服务通信，因此任何 console.log() 语句都会干扰通信并导致 JSON 解析错误。

添加到 Cursor

要将此 MCP 服务添加到 Cursor：

1. 首先使用 npm run build 构建项目
2. 在 Cursor 中，前往 Settings > MCP Servers
3. 点击“Add Server”
4. 使用以下设置配置服务：
   • Name：Sequential Thinking MCP（或你喜欢的任何名称）
   • Type：command
   • Command：node
   • Arguments：/path/to/sequential-thinking-recall/dist/index.js（替换为你的实际路径）
   • Environment Variables：
     • RECALL_PRIVATE_KEY：你的私钥（可带或不带“0x”前缀）
     • RECALL_NETWORK：testnet（如有需要，也可使用 mainnet）
     • RECALL_BUCKET_ALIAS：sequential-thinking-logs
     • RECALL_LOG_PREFIX：sequential-
5. 点击“Save”

在 Cursor 配置中使用环境变量

为提高安全性，你可以通过主目录中的 .cursor/mcp.json 文件配置 Cursor：

{
  "mcpServers": {
    "sequential-thinking-mcp": {
      "command": "node",
      "args": [
        "/Users/yourusername/sequential-thinking-recall/dist/index.js"
      ],
      "env": {
        "RECALL_PRIVATE_KEY": "your-private-key-here",
        "RECALL_NETWORK": "testnet",
        "RECALL_BUCKET_ALIAS": "sequential-thinking-logs",
        "RECALL_LOG_PREFIX": "sequential-"
      }
    }
  }
}

这种方式无需使用 .env 文件。

添加到 Claude Desktop

要将此 MCP 服务添加到 Claude Desktop：

1. 首先使用 npm run build 构建项目

2. 找到你的 Claude Desktop 配置文件：

   • 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
   • 在 Windows 上：%APPDATA%\Claude\claude_desktop_config.json
   • 在 Linux 上：~/.config/Claude/claude_desktop_config.json

3. 创建或编辑 claude_desktop_config.json 文件，并填入以下内容：

   {
     "mcpServers": {
       "sequential-thinking-mcp": {
         "command": "node",
         "args": [
           "/path/to/sequential-thinking-recall/dist/index.js"
         ],
         "env": {
           "RECALL_PRIVATE_KEY": "your-private-key-here",
           "RECALL_NETWORK": "testnet",
           "RECALL_BUCKET_ALIAS": "sequential-thinking-logs",
           "RECALL_LOG_PREFIX": "sequential-"
         }
       }
     }
   }
   

4. 将 /path/to/sequential-thinking-recall/dist/index.js 替换为编译后的服务文件的完整路径

   • 示例：/Users/username/sequential-thinking-recall/dist/index.js

5. RECALL_PRIVATE_KEY 可以带或不带“0x”前缀，两种格式都可以使用

6. 保存配置文件并重启 Claude Desktop

许可证

此 MCP 服务采用 MIT 许可证。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目代码库中的 LICENSE 文件。