返回市场
顺序思维MCP服务器

顺序思维MCP服务器

作者:zengwenliang41639 星标更新:2025-03-13

项目介绍

顺序思维 MCP 服务器

<div align="center">

License: MIT Language Platform

English | 中文

</div>

📖 概述

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

✨ 特性

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

🛠️ 工具接口

sequential_thinking

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

输入参数

参数类型必填描述
thoughtstring当前思考步骤
nextThoughtNeededboolean是否需要另一个思考步骤
thoughtNumberinteger当前思考次数
totalThoughtsinteger预计所需的总思考次数
isRevisionboolean是否修订之前的思考
revisesThoughtinteger正在重新考虑的思考编号
branchFromThoughtinteger分支点思考编号
branchIdstring分支标识符
needsMoreThoughtsboolean是否需要更多的思考

🎯 使用场景

顺序思维工具适用于:

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

⚙️ 集成方法

与 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
  1. 在 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
  1. 在 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 .
  1. 在 Cursor 设置中配置(JSON):
{
  8 "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
  1. 添加到 mcp_config.json
{
  "mcpServers": {
    "sequential-thinking": {
      "command": "node",
      "args": [
        "/absolute/path/to/sequential-thinking/dist/index.js"
      ]
    }
  }
}
  1. 设置可执行权限:
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 服务器"
    }
    
  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. 转到仓库设置 → 密钥和变量 → 动作
  2. 点击“新建仓库密钥”按钮
  3. 单独添加每个密钥:
    • NPM_TOKEN:粘贴你的 npm 访问令牌值
    • DOCKERHUB_USERNAME:输入你的 Docker Hub 用户名
    • DOCKERHUB_TOKEN:粘贴你的 Docker Hub 访问令牌
  4. 添加所有密钥后,你应该在“动作密钥”列表中看到这三条

测试工作流

要测试你的自动化发布工作流:

  1. 在你的 GitHub 仓库中,点击“动作”标签
  2. 在左侧边栏找到“发布包”工作流
  3. 点击“运行工作流”按钮
  4. 从分支下拉菜单中选择“main”分支
  5. 点击绿色的“运行工作流”按钮
  6. 在“动作”标签中监控进度和结果

对于启用双重身份验证的用户:如果你的 npm 账户启用了双重身份验证,你必须:

  • 使用“自动化”类型的令牌(推荐)
  • 更改双重身份验证设置为“仅授权”(不推荐)
  • 手动发布包(非自动化)
</details>

❗ 故障排除

如果遇到集成问题:

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

📄 许可证

该项目基于 MIT 许可证 - 详情见 LICENSE 文件。

🔗 源代码

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