顺序思考 MCP 服务器

<div align="center">

English | 中文

</div>

📖 概述

一个强大的 MCP 服务器，实现了顺序思考协议，提供了一种结构化的解决问题的方法。该服务器有助于将复杂问题分解为可管理的步骤，同时保持修改和替代推理路径的灵活性。

✨ 特性

• 🔍 结构化分析 - 将复杂问题分解为可管理的步骤
• 🔄 迭代改进 - 随着理解的加深，修改和改进想法
• 🌲 替代路径 - 分支到替代的推理路径
• 📊 动态调整 - 根据需要调整总思考次数
• ✅ 解决方案验证 - 生成并验证解决方案假设

🛠️ 工具接口

sequential_thinking

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

输入参数

参数	类型	必需	描述
thought	string	是	当前的思考步骤
nextThoughtNeeded	boolean	是	是否需要另一个思考步骤
thoughtNumber	integer	是	当前的思考编号
totalThoughts	integer	是	估计需要的总思考次数
isRevision	boolean	否	这是否修改了之前的思考
revisesThought	integer	否	正在重新考虑哪个思考
branchFromThought	integer	否	分支点的思考编号
branchId	string	否	分支标识符
needsMoreThoughts	boolean	否	是否需要更多思考

🎯 使用场景

顺序思考工具非常适合：

• 📝 需要逐步分解的复杂问题
• 🎨 需要迭代改进的规划和设计项目
• 🔄 可能需要修正方向的分析工作流程
• 🌐 初始范围不明确的情况
• 📚 需要在多个步骤中保持上下文的任务
• 🔍 从复杂场景中过滤掉不相关的信息

⚙️ 集成方法

与 Claude Desktop 一起使用

<details> <summary><b>📦 NPX 配置</b></summary>

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@zengwenliang/mcp-server-sequential-thinking"
      ]
    }
  }
}

</details>

<details> <summary><b>🐳 Docker 配置</b></summary>

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "zengwenliang0416/mcp-server-sequential-thinking"
      ]
    }
  }
}

</details>

与 Cursor IDE 一起使用

<details> <summary><b>📦 NPX 方法 (推荐)</b></summary>

1. 安装包:

# 全局安装
npm install -g @zengwenliang/mcp-server-sequential-thinking

# 或者直接使用 NPX
npx -y @zengwenliang/mcp-server-sequential-thinking

2. 在 Cursor 设置中配置 (JSON):

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@zengwenliang/mcp-server-sequential-thinking"
      ]
    }
  }
}

</details>

<details> <summary><b>💻 本地构建方法</b></summary>

1. 本地构建:

cd /path/to/sequential-thinking
npm install
npm run build

2. 在 Cursor 设置中配置 (JSON):

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "node",
      "args": [
        "/absolute/path/to/sequential-thinking/dist/index.js"
      ]
    }
  }
}

</details>

<details> <summary><b>🐳 Docker 方法</b></summary>

1. 构建 Docker 镜像:

# 构建 Docker 镜像
docker build -t zengwenliang0416/mcp-server-sequential-thinking .

2. 在 Cursor 设置中配置 (JSON):

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "zengwenliang0416/mcp-server-sequential-thinking"
      ]
    }
  }
}

</details>

<details> <summary><b>🔧 环境变量方法</b></summary>

1. 创建启动脚本:

#!/bin/sh
export CURSOR_MCP_CONFIG=/path/to/your/mcp_config.json
open -a Cursor

2. 添加到 mcp_config.json:

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "node",
      "args": [
        "/absolute/path/to/sequential-thinking/dist/index.js"
      ]
    }
  }
}

3. 使其可执行:

chmod +x start_cursor_with_mcp.sh

注意: MCP 集成主要在 Cursor IDE 的 Composer 功能中支持。 </details>

🚀 从源码构建

<details> <summary><b>本地构建</b></summary>

git clone https://github.com/zengwenliang416/mcp-server-sequential-thinking.git
cd mcp-server-sequential-thinking
npm install
npm run build

</details>

<details> <summary><b>Docker 构建</b></summary>

git clone https://github.com/zengwenliang416/mcp-server-sequential-thinking.git
cd mcp-server-sequential-thinking
docker build -t zengwenliang0416/mcp-server-sequential-thinking .

# 验证构建
docker images | grep sequential-thinking

</details>

📄 发布指南

<details> <summary><b>发布到 npm</b></summary>

前提条件

• 安装了 Node.js 和 npm
• 具有访问 @zengwenliang 范围的 npm 帐户
• 本地构建的包

发布步骤

1. 更新 package.json 中的版本

   {
     "name": "@zengwenliang/mcp-server-sequential-thinking",
     "version": "0.6.4",
     "description": "MCP server for sequential thinking and problem solving"
   }
   

2. 使用官方 npm 注册表

   npm config set registry https://registry.npmjs.org/
   

3. 登录到 npm

   npm login
   

   按照提示通过浏览器登录。

4. 检查组织成员资格 对于作用域包，请确保您是作用域的一部分：

   # 检查您是否是组织的一部分
   npm org ls your-org-name
   
   # 对于个人作用域，这将使用您的用户名自动创建
   

5. 构建和发布

   npm run build
   
   # 对于首次发布作用域包
   npm publish --access public
   
   # 对于后续更新
   npm publish
   

6. 验证发布

   npm view @zengwenliang/mcp-server-sequential-thinking
   

7. 提交您的更改

   git add .
   git commit -m "feat(publish): 🚀 发布npm包@zengwenliang/mcp-server-sequential-thinking"
   git push
   

版本更新

使用语义版本控制：

# 对于补丁（错误修复）
npm version patch

# 对于次要更新（功能）
npm version minor

# 对于主要更新（重大更改）
npm version major

更新版本后，再次构建和发布：

npm run build
npm publish

</details>

🔐 CI/CD 配置

<details> <summary><b>设置 GitHub Actions</b></summary>

必需的密钥

将这些密钥添加到您的存储库设置中：

1. NPM_TOKEN

   • 在 npm 上生成：帐户 → 访问令牌 → “自动化”令牌类型
   • 逐步说明：
     1. 登录到您的 npm 帐户：https://www.npmjs.com/login
     2. 单击您的个人资料图片，然后选择“访问令牌”
     3. 单击“生成新令牌”按钮
     4. 重要提示：选择“自动化”令牌类型（而不是“发布”）以绕过 OTP 要求
     5. 输入令牌描述（例如，“GitHub Actions”）
     6. 单击“生成令牌”
     7. 重要提示：立即复制生成的令牌！它只会显示一次

2. DOCKERHUB_USERNAME

   • 您的 Docker Hub 用户名
   • 这应该与您用于登录 Docker Hub 的用户名相同

3. DOCKERHUB_TOKEN

   • 在 Docker Hub 中生成：帐户设置 → 安全 → 新访问令牌
   • 逐步说明：
     1. 登录到您的 Docker Hub 帐户
     2. 单击您的用户名，然后选择“帐户设置”
     3. 从左侧导航栏中选择“安全”
     4. 单击“新访问令牌”
     5. 输入描述并选择适当的权限（至少“读取和写入”）
     6. 单击“生成”
     7. 立即复制生成的令牌！它只会显示一次

将密钥添加到 GitHub

1. 转到存储库设置 → 密钥和变量 → Actions
2. 单击“新建存储库密钥”按钮
3. 单独添加每个密钥：
   • NPM_TOKEN：粘贴您的 npm 访问令牌值
   • DOCKERHUB_USERNAME：输入您的 Docker Hub 用户名
   • DOCKERHUB_TOKEN：粘贴您的 Docker Hub 访问令牌
4. 添加所有密钥后，您应该在“Actions 密钥”列表中看到所有 3 个密钥

测试工作流程

要测试您的自动发布工作流程：

1. 在您的 GitHub 存储库中，单击“Actions”选项卡
2. 在左侧边栏中找到“Publish Package”工作流程
3. 单击“运行工作流程”按钮
4. 从分支下拉列表中选择“main”分支
5. 单击绿色的“运行工作流程”按钮
6. 在 Actions 选项卡中监视进度和结果

2FA 用户注意事项：如果您在 npm 帐户上启用了双因素身份验证，则必须：

• 使用“自动化”类型令牌（推荐）
• 将 2FA 设置更改为“仅授权”（不推荐）
• 手动发布包（非自动化） </details>

❗ 故障排除

如果您遇到集成问题：

1. 🔧 使用带有 JS 文件绝对路径的本地构建方法
2. 📝 验证文件权限：chmod +x dist/index.js
3. 🐳 尝试 Docker 作为替代方案
4. 📚 查阅 Cursor 的文档以获取最新的 MCP 集成方法

📄 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

🔗 源代码

基于 modelcontextprotocol/servers 并在 zengwenliang416/mcp-server-sequential-thinking 维护。