思考工具

Name: 思考工具
Author: fourcolors

作者：fourcolors6 星标更新：2025-08-30

安装使用来源：spider==github.com

项目介绍

MCP反思工具

一个模型上下文协议（MCP）服务器，提供了一个“反思”工具，用于AI助手创建认知检查点和结构化推理。此工具帮助大语言模型维持上下文、反思其工作，并系统地思考复杂问题。

为什么使用此工具？

关键见解： 不显式输出思维过程，则不会进行深度思考。此工具创建强制性的认知检查点，防止走捷径并提高准确性。

特性

🧠 结构化推理：强制AI助手逐步通过复杂问题进行反思
✅ 任务验证：创建检查点以验证需求是否得到满足
📝 学习文档：在解决问题过程中捕捉发现和见解
🔍 调试辅助：通过排除法系统地解决难题
🎯 决策审计轨迹：为重要决策创建推理记录

安装

快速安装通过NPM

# 全局安装
npm install -g mcp-reflection-tool

# 或直接运行无需安装
npx mcp-reflection-tool

与AI工具集成

Claude Code

使用单个命令添加服务器：

mcp add npx mcp-reflection-tool

这将自动配置服务器到您的Claude Code设置中。运行命令后，请完全重启Claude Code。

Cursor

添加到您的Cursor配置中：

选项1：通过设置UI

打开Cursor设置（Cmd/Ctrl + ,）
搜索"MCP"或导航至功能>MCP
添加反思工具配置

选项2：直接编辑配置

编辑~/.cursor/mcp_config.json：

{
  "mcpServers": {
    "reflection-tool": {
      "command": "npx",
      "args": ["mcp-reflection-tool"]
    }
  }
}

更改后重启Cursor。

Windsurf

添加到您的Windsurf MCP配置中：

位置：~/.windsurf/mcp.json（macOS/Linux）或%USERPROFILE%\.windsurf\mcp.json（Windows）

{
  "mcpServers": {
    "reflection-tool": {
      "command": "npx",
      "args": ["mcp-reflection-tool"]
    }
  }
}

更改后重启Windsurf。

Cline（VS Code扩展）

选项1：通过VS Code设置UI

打开VS Code设置（Cmd/Ctrl + ,）
搜索"Cline MCP"
添加服务器配置

选项2：编辑settings.json

添加到您的VS Code settings.json：

{
  "cline.mcpServers": {
    "reflection-tool": {
      "command": "npx",
      "args": ["mcp-reflection-tool"]
    }
  }
}

配置后重新加载VS Code窗口。

替代方案：手动服务器模式

服务器默认通过stdio运行。如需HTTP模式，请使用环境变量：

# 在stdio模式下启动服务器（默认）
npx mcp-reflection-tool

# 在端口8080上启动HTTP模式
HTTP=true npx mcp-reflection-tool

# 在自定义端口上启动HTTP模式
HTTP=true PORT=3000 npx mcp-reflection-tool

大多数现代AI工具会自动支持stdio模式。

使用示例

安装后，AI助手将能够访问reflect工具。以下是一些使用示例：

复杂操作前

使用反思工具："分解身份验证实现：
1. 检查代码库中的现有身份验证模式
2. 设置JWT令牌生成
3. 添加路由保护中间件
4. 使用有效和过期令牌测试"

完成任务后

使用反思工具："任务完成检查：
- 已完成：实现了带有JWT的用户身份验证
- 学习：现有的中间件使集成变得顺畅
- 技术债务：需要添加速率限制
- 下一步：更新API文档"

解决问题时

使用反思工具："调试慢API响应：
- 症状：5秒以上响应时间
- 假设1：缺少数据库索引 - 已确认
- 假设2：N+1查询问题 - 也找到
- 解决方案：添加复合索引和查询批处理
- 结果：响应时间现在小于200毫秒"

工具何时被使用

AI助手将自动使用此工具作为认知草稿纸，用于：

🔍 链式思维推理通过复杂问题
📋 规划您的方法在采取行动之前
✅ 反思结果在完成任务之后
✔️ 验证需求是否得到满足
📝 记录发现和学习
🎯 创建无法跳过的认知检查点

这有助于AI逐步思考，提高准确性和合规性。

开发

预备条件

Node.js 18+ 或 Bun 运行时
npm 或 bun 包管理器

设置

# 克隆仓库
git clone https://github.com/sterling/think-tool.git
cd think-tool

# 安装依赖
bun install
# 或
npm install

# 在开发模式下运行（带热重载）
bun run dev
# 或
npm run dev

从源码构建

# 将TypeScript编译为JavaScript
bun run build
# 或
npm run build

# 运行构建版本
bun start
# 或
npm start

项目结构

├── src/
│   └── server.ts      # TypeScript源代码
├── dist/              # 构建的JavaScript（生成）
│   ├── server.js      # 主服务器文件
│   └── cli.js         # CLI可执行文件
├── package.json       # NPM包配置
└── tsconfig.json      # TypeScript配置

配置

环境变量

PORT：服务器端口（默认：8080）
```
PORT=3000 npx mcp-reflection-tool
```

工作原理

反思工具实现了模型上下文协议（MCP），为AI助手提供了一种标准化方式来访问外部工具。当AI助手需要反思一个问题时：

AI调用reflect工具并传递其推理
工具将思维过程记录到服务器控制台
工具向AI确认检查点
这创建了一个认知检查点，提高了推理质量

这种“大声思考”的效果已被证明显著提高了AI响应的准确性和完整性。

故障排除

常见问题

端口已占用

# 使用不同的端口
PORT=8081 npx mcp-reflection-tool

权限被拒绝

# 使用适当的权限全局重新安装
sudo npm install -g mcp-reflection-tool

工具在AI助手不可用

确保MCP服务器正在运行
添加配置后重启您的AI工具
检查配置文件中的有效JSON语法
验证配置文件的位置适用于您的操作系统

查看日志

服务器日志：可见于服务器运行的终端
Claude Code日志：~/Library/Logs/Claude/mcp*.log（macOS）
VS Code日志：视图>输出>从下拉菜单选择"Cline"
Cursor日志：帮助>切换开发者工具>控制台

验证安装

# 检查是否全局安装了包
npm list -g mcp-reflection-tool

# 直接测试服务器
npx mcp-reflection-tool

# 测试stdio模式
echo '{"jsonrpc":"2.0","method":"initialize","id":1}' | npx mcp-reflection-tool

贡献

欢迎贡献！请随时提交Pull Request。

分叉仓库
创建您的功能分支（git checkout -b feature/amazing-feature）
提交您的更改（git commit -m '添加精彩功能'）
推送到分支（git push origin feature/amazing-feature）
打开Pull Request

许可

MIT许可 - 详情见LICENSE文件。

作者

作为增强AI推理能力的MCP实现而创建。

链接

致谢

使用FastMCP框架构建
实现模型上下文协议标准
受结构化推理研究对AI系统的影响