AI导哈

顺序思维MCP服务器

一个实现动态和反思性解决问题的MCP服务器，通过结构化思维过程自动将顺序思维日志写入Recall。

  • by recallnet
  • TypeScript
  • 本地部署
  • 18 星标
  • 更新于
在 GitHub 查看 recallnet/sequential-thinking-recall

使用说明

顺序思维MCP服务器

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

特性

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

  • 逐步解决问题

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

  • 假设管理

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

  • 召回集成

    • 将所有顺序思维会话安全地存储在链上
    • 访问完整的思想史
    • 检索特定的思考环节
    • 列出所有已存储的会话

安全⚠️

重要：私钥保护

此MCP服务器需要私钥才能进行召回操作。为了保护这些敏感信息：

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

多层保护

此服务器实现了几层安全措施来保护您的私钥安全：

1.私钥隔离

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

2.日志保护

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

3.防止进入

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

召回集成

此MCP服务器包括与 召回，允许您在链上安全地存储顺序思维日志。每个查询的所有思考步骤都会自动保存到您的Recall存储桶中。

配置

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

  • RECALL_PRIVATE_KEY （必填）：您的Recall私钥
  • RECALL_NETWORK （可选）：要连接的网络（测试网或主网，默认为测试网）
  • RECALL_BUCKET_ALIAS （可选）：存储日志的存储桶的别名（默认为“顺序思维日志”）
  • 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文件。

    • 当通过配置提供时，服务器将自动使用这些环境变量。
    • 有关具体的设置说明，请参阅下面的“添加到光标”和“添加到Claude桌面”部分。

    方法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 逐步思考并存储在回忆中 thought：字符串， nextThoughtNeeded：布尔值， thoughtNumber：整数， totalThoughts：整数，加上可选参数
recallstatus 获取Recall集成的状态 check：布尔值
listsessions 列出所有连续的思考环节 includePortalLinks?：布尔值
getsession 进行一次特定的思考会议 key：字符串

顺序思维

为解决问题和分析提供详细的、循序渐进的思维过程。

输入：

  • thought （string）：当前思考步骤
  • nextThoughtNeeded （boolean）：是否需要另一个思考步骤
  • thoughtNumber （整数）：当前思想数
  • totalThoughts （整数）：估计所需的总想法
  • isRevision （boolean，可选）：这是否改变了之前的想法
  • revisesThought （整数，可选）：正在重新考虑哪个想法
  • branchFromThought （整数，可选）：分支点思想数
  • branchId （字符串，可选）：分支标识符
  • needsMoreThoughts （boolean，可选）：如果需要更多想法

输出： 当提交最终想法时(nextThoughtNeeded =false），工具返回：

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

回顾状态

获取Recall集成的状态。

输入：

  • check （boolean）：设置为true以检查状态

输出：

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

列表会话

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

输入：

  • includePortalLinks （布尔值，可选）：是否包含每个会话的门户链接

输出：

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

getsession

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

输入：

  • key （string）：要检索的会话的密钥/文件名

输出：

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

用法

顺序思维工具旨在：

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

建筑

npm run build
npm run start

发展模式

npm run dev

发展重要提示

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

添加到光标

要将此MCP服务器添加到游标，请执行以下操作：

  1. 首先构建项目 npm run build
  2. 在光标中，转到设置>MCP服务器
  3. 点击“添加服务器”
  4. 使用以下设置配置服务器：
    • 名字: Sequential Thinking MCP （或您喜欢的任何名称）
    • 类型: command
    • 命令: node
    • 参数: /path/to/sequential-thinking-recall/dist/index.js （替换为您的实际路径）
    • 环境变量:
      • RECALL_PRIVATE_KEY：您的私钥（带或不带“0x”前缀）
      • RECALL_NETWORK: testnet （或 mainnet 如果需要）
      • RECALL_BUCKET_ALIAS: sequential-thinking-logs
      • RECALL_LOG_PREFIX: sequential-
  5. 点击“保存”

在游标配置中使用环境变量

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

{
  "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桌面

要将此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文件。

相关 MCP