顺序思考 MCP 服务器

一个 MCP 服务器实现，提供了一个工具，通过结构化的思考过程进行动态和反思性的问题解决，该过程自动将顺序思考日志写入与每个思考会话相关的 Recall。

功能

顺序思考 MCP 提供以下功能：

• 逐步问题解决

  • 将复杂问题分解为可管理的步骤
  • 随着理解的加深，修改和完善想法
  • 分支到替代的推理路径
  • 动态调整想法的总数

• 假设管理

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

• Recall 集成

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

安全 ⚠️

重要提示：私钥保护

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

1. 切勿共享您的私钥或 .env 文件内容
2. 切勿运行显示您的私钥的命令（例如 cat .env）
3. 未经您的批准，切勿允许 LLM 直接执行 shell 命令
4. 如果使用 .env 文件，请使用受限权限存储它：chmod 600 .env

多层保护

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

1. 私钥隔离

• 您的私钥仅在初始化期间加载
• 加载后，密钥会立即从环境变量中删除
• 实际密钥永远不会被记录或传输到 LLM

2. 日志保护

• 自动编辑日志中的任何私钥模式
• 过滤控制台输出，将私钥替换为 [REDACTED]
• 对象清理，在显示之前屏蔽敏感字段

3. 访问预防

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

Recall 集成

此 MCP 服务器包含与 Recall 的集成，允许您将顺序思考日志安全地存储在链上。 每个查询的所有思考步骤都会自动保存到您的 Recall bucket。

配置

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

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

每个想法都单独存储，并带有其元数据，完整的思考会话在完成后存储。 这允许您：

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

环境变量优先级

顺序思考 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: String, nextThoughtNeeded: Boolean, thoughtNumber: Integer, totalThoughts: Integer, 加上可选参数
recallstatus	获取 Recall 集成的状态	check: Boolean
listsessions	列出所有顺序思考会话	includePortalLinks?: Boolean
getsession	获取特定的思考会话	key: String

sequentialthinking

促进详细的、逐步的思考过程，用于问题解决和分析。

输入：

• thought (string): 当前的思考步骤
• nextThoughtNeeded (boolean): 是否需要另一个思考步骤
• thoughtNumber (integer): 当前思考编号
• totalThoughts (integer): 估计需要的总思考数
• isRevision (boolean, optional): 这是否修改了之前的思考
• revisesThought (integer, optional): 正在重新考虑哪个思考
• branchFromThought (integer, optional): 分支点思考编号
• branchId (string, optional): 分支标识符
• needsMoreThoughts (boolean, optional): 是否需要更多思考

输出： 当提交最终思考时 (nextThoughtNeeded = false)，该工具返回：

• 带有以下内容的 recallInfo：
  • txHash: Recall 网络上的交易哈希
  • success: 存储是否成功
  • key: 会话文件名
  • viewUrl: 指向 Recall 门户中会话的直接链接

recallstatus

获取 Recall 集成的状态。

输入：

• check (boolean): 设置为 true 以检查状态

输出：

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

listsessions

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

输入：

• includePortalLinks (boolean, optional): 是否包含每个会话的门户链接

输出：

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

getsession

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

输入：

• key (string): 要检索的会话的键/文件名

输出：

• 请求的会话文件的完整内容，包括所有想法和元数据
• 指向 Recall 门户中会话的门户链接

用法

顺序思考工具专为以下目的而设计：

• 将复杂问题分解为步骤
• 规划和设计，并留有修改空间
• 可能需要纠正的分析
• 最初可能不清楚全部范围的问题
• 需要在多个步骤中保持上下文的任务
• 需要过滤掉无关信息的情况

构建

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 文件。