MCP server for sequential thinking and problem solving



一个强大的MCP服务器,实现了顺序思维协议,提供结构化的问题解决方法。该服务器帮助将复杂问题分解为可管理的步骤,同时保持修订和替代推理路径的灵活性。
- 🔍 结构化分析 - 将复杂问题分解为可管理的步骤
- 🔄 迭代改进 - 随着理解的加深,修订和完善思路
- 🌲 多路径思考 - 分支到替代推理路径
- 📊 动态调整 - 根据需要调整思考步骤总数
- ✅ 解决方案验证 - 生成和验证解决方案假设
促进详细的逐步思维过程,用于问题解决和分析。
#### 输入参数
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| thought | 字符串 | 是 | 当前思维步骤 |
| nextThoughtNeeded | 布尔值 | 是 | 是否需要另一个思维步骤 |
| thoughtNumber | 整数 | 是 | 当前思维编号 |
| totalThoughts | 整数 | 是 | 估计所需的总思维数 |
| isRevision | 布尔值 | 否 | 是否修订之前的思维 |
| revisesThought | 整数 | 否 | 正在重新考虑的思维 |
| branchFromThought | 整数 | 否 | 分支点思维编号 |
| branchId | 字符串 | 否 | 分支标识符 |
| needsMoreThoughts | 布尔值 | 否 | 是否需要更多思维 |
顺序思维工具特别适合:
- 📝 需要逐步分解的复杂问题
- 🎨 需要迭代改进的规划和设计项目
- 🔄 可能需要调整方向的分析工作流
- 🌐 初始范围不完全清晰的情境
- 📚 需要在多个步骤中保持上下文的任务
- 🔍 从复杂场景中过滤无关信息
📦 NPX 配置
``json`
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": [
"-y",
"@zengwenliang/mcp-server-sequential-thinking"
]
}
}
}
🐳 Docker 配置
`json`
{
"mcpServers": {
"sequential-thinking": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"zengwenliang0416/mcp-server-sequential-thinking"
]
}
}
}
📦 NPX 方法(推荐)
1. 安装包:
`bash全局安装
npm install -g @zengwenliang/mcp-server-sequential-thinking
2. 在 Cursor 设置中配置(JSON):
`json
{
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": [
"-y",
"@zengwenliang/mcp-server-sequential-thinking"
]
}
}
}
`
💻 本地构建方法
1. 本地构建:
`bash
cd /path/to/sequential-thinking
npm install
npm run build
`2. 在 Cursor 设置中配置(JSON):
`json
{
"mcpServers": {
"sequential-thinking": {
"command": "node",
"args": [
"/absolute/path/to/sequential-thinking/dist/index.js"
]
}
}
}
`
🐳 Docker 方法
1. 构建 Docker 镜像:
`bash
构建 Docker 镜像
docker build -t zengwenliang0416/mcp-server-sequential-thinking .
`2. 在 Cursor 设置中配置(JSON):
`json
{
"mcpServers": {
"sequential-thinking": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"zengwenliang0416/mcp-server-sequential-thinking"
]
}
}
}
`
🔧 环境变量方法
1. 创建启动脚本:
`bash
#!/bin/sh
export CURSOR_MCP_CONFIG=/path/to/your/mcp_config.json
open -a Cursor
`2. 在
mcp_config.json 中添加配置:
`json
{
"mcpServers": {
"sequential-thinking": {
"command": "node",
"args": [
"/absolute/path/to/sequential-thinking/dist/index.js"
]
}
}
}
`3. 使脚本可执行:
`bash
chmod +x start_cursor_with_mcp.sh
`> 注意:MCP 集成主要在 Cursor IDE 的 Composer 功能中支持。
🚀 从源码构建
本地构建
`bash
git clone https://github.com/zengwenliang416/mcp-server-sequential-thinking.git
cd mcp-server-sequential-thinking
npm install
npm run build
`
Docker 构建
`bash
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
`
📦 发布指南
发布到 npm
$3
- 已安装 Node.js 和 npm
- 拥有可访问 @zengwenliang 作用域的 npm 账号
- 本地已构建的包
$3
1. 更新 package.json 中的版本
`json
{
"name": "@zengwenliang/mcp-server-sequential-thinking",
"version": "0.6.4",
"description": "MCP server for sequential thinking and problem solving"
}
`2. 使用官方 npm 注册表
`bash
npm config set registry https://registry.npmjs.org/
`3. 登录 npm
`bash
npm login
`
按照提示通过浏览器登录。4. 检查组织成员身份
对于作用域包,确保您是该作用域的一部分:
`bash
# 检查您是否是组织的成员
npm org ls 您的组织名称 # 对于个人作用域,这会自动使用您的用户名创建
`5. 构建并发布
`bash
npm run build
# 首次发布作用域包
npm publish --access public
# 后续更新
npm publish
`6. 验证发布
`bash
npm view @zengwenliang/mcp-server-sequential-thinking
`7. 提交您的更改
`bash
git add .
git commit -m "feat(publish): 🚀 发布npm包@zengwenliang/mcp-server-sequential-thinking"
git push
`$3
使用语义化版本:
`bash
补丁更新(错误修复)
npm version patch次要更新(新功能)
npm version minor主要更新(破坏性变更)
npm version major
`更新版本后,再次构建和发布:
`bash
npm run build
npm publish
`
🔐 CI/CD 配置
设置 GitHub Actions
$3
添加这些密钥到您的仓库设置:
1. NPM_TOKEN
- 在 npm 生成:账户 → 访问令牌 → 选择"Automation"令牌类型
- 详细步骤:
1. 登录您的 npm 账户:https://www.npmjs.com/login
2. 点击右上角的个人头像,然后选择"Access Tokens"
3. 点击"Generate New Token"按钮
4. 重要:选择"Automation"类型的令牌(不是"Publish")以绕过 OTP 要求
5. 填写令牌描述(例如:"GitHub Actions")
6. 点击"Generate Token"按钮
7. 重要:立即复制生成的令牌!它只会显示一次
2. DOCKERHUB_USERNAME
- 您的 Docker Hub 用户名
- 这应该是您用于登录 Docker Hub 的相同用户名
3. DOCKERHUB_TOKEN
- 在 Docker Hub 生成:账户设置 → 安全 → 新访问令牌
- 详细步骤:
1. 登录您的 Docker Hub 账号
2. 点击右上角的用户名,然后选择"Account Settings"
3. 在左侧导航栏中选择"Security"
4. 点击"New Access Token"
5. 填写描述并选择适当的权限(至少需要"Read & Write"权限)
6. 点击"Generate"按钮
7. 立即复制生成的令牌!它只会显示一次
$3
1. 进入仓库设置 → Secrets and variables → Actions
2. 点击"New repository secret"按钮
3. 逐个添加每个密钥:
- NPM_TOKEN:粘贴您的 npm 访问令牌值
- DOCKERHUB_USERNAME:输入您的 Docker Hub 用户名
- DOCKERHUB_TOKEN:粘贴您的 Docker Hub 访问令牌
4. 添加完所有密钥后,您应该在"Actions secrets"列表中看到全部 3 个密钥
$3
要测试自动发布工作流:
1. 在您的 GitHub 仓库中,点击"Actions"选项卡
2. 在左侧找到"Publish Package"工作流
3. 点击"Run workflow"按钮
4. 从分支下拉菜单中选择"main"分支
5. 点击绿色的"Run workflow"按钮
6. 在 Actions 标签页中监控进度和结果
> 双因素认证用户注意:如果您在 npm 账户上启用了双因素认证(2FA),您必须:
> - 使用"Automation"类型的令牌(推荐)
> - 将双因素认证设置更改为"仅登录时验证"(不推荐)
> - 手动发布包(无法自动化)
❗ 故障排除
如果您遇到集成问题:
1. 🔧 使用本地构建方法,提供 JS 文件的绝对路径
2. 📝 确认文件权限:
chmod +x dist/index.js`本项目根据 MIT 许可证进行许可 - 详见 LICENSE 文件。
基于 modelcontextprotocol/servers 的源代码,并在 zengwenliang416/mcp-server-sequential-thinking 维护。