思维工具服务器

一个基于模型上下文协议(MCP)的服务器,为大型语言模型(LLM)提供结构化思维空间,增强复杂推理能力。

  • by abhinav-mangla
  • TypeScript
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 abhinav-mangla/think-tool-mcp

使用说明

MCP思维工具服务器

一种模型上下文协议(MCP)服务器,它实现了“思考”工具,用于增强大型语言模型(LLM)中的复杂推理能力。该工具为LLM在解决问题的任务中提供了一个专门的结构化思维空间,显著提高了在需要政策遵守和多步骤推理的复杂场景中的性能。

🧠 概述

Think Tool MCP服务器基于Anthropic的研究,该研究表明,为LLM提供专用的“思维空间”可以显著提高复杂任务的性能。此工具允许任何兼容的LLM(Claude、GPT-4等):

  • 将复杂问题分解为可管理的步骤
  • 执行结构化推理和分析
  • 在决策过程中验证政策合规性
  • 处理和综合来自多个工具调用的信息
  • 在长推理链中保持上下文和逻辑流

如所述 Anthropic的博客文章,think工具在需要跨不同语言模型进行复杂推理和策略遵守的任务中显示出了显著的改进。

✨ 特性

  • 🔧 结构化思维空间:为LLM提供用于复杂推理的专用环境
  • 📝 记忆辅助:有助于在长链的工具调用过程中维护上下文
  • 🎯 策略验证:允许仔细检查策略遵守情况
  • 🔍 问题分解:支持将复杂问题分解为步骤
  • ⚡ 轻量级:通过高效的MCP实施实现最小的开销
  • 🔌 易于集成:使用流行的AI平台(Cursor、Claude Desktop等)进行简单设置
  • 🛠️ TypeScript:使用TypeScript构建,实现类型安全和更好的开发体验
  • 🌐 通用兼容性:适用于支持模型上下文协议的任何LLM

🚀 平台配置

光标IDE

需求:光标版本0.45.6或更高

  1. 打开 光标设置 (Cmd/Ctrl + ,)
  2. 导航至 特性 → MCP服务器
  3. 点击 “+添加新的MCP服务器”
  4. 配置服务器:
    • 名字: think-tool-mcp (或您喜欢的名字)
    • 类型: command
    • 命令: npx -y think-tool-mcp
  5. 保存并重新启动游标

克劳德桌面版

添加到您的 claude_desktop_config.json:

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

配置文件位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json

其他MCP兼容平台

此服务器适用于支持模型上下文协议的任何平台。有关MCP服务器配置,请参阅您的平台文档。

📊 性能分析

Anthropic的广泛研究表明,当LLM使用思维工具时,性能有了显著提高。以下结果展示了不同基准和用例的可衡量影响。

τ-台架(Tau Bench)结果

τ-Bach是一个全面的基准测试,旨在测试LLM工具在现实客户服务场景中的使用情况。它评估了驾驭复杂对话、遵循详细政策指导方针以及在多个任务试验中保持一致性的能力。

航空公司领域性能

航空公司领域代表了一个复杂的政策密集型环境,精确遵守详细规则至关重要。

配置 k=1 k=2 k=3 k=4 k=5
Think+优化提示 0.584 0.444 0.384 0.356 0.340
单独思考工具 0.404 0.254 0.186 0.140 0.100
扩展思维 0.412 0.290 0.232 0.192 0.160
基线(无思考工具) 0.332 0.206 0.148 0.116 0.100

主要发现:

  • 相对改善54% 通过^1指标(0.584 vs 0.370基线)
  • 通过示例优化提示,大大提高了性能
  • 在所有试验一致性水平(k=1至k=5)上保持改进

零售领域性能

零售领域的政策更简单,即使没有广泛的提示,思考工具也能显示出好处。

配置 k=1 k=2 k=3 k=4 k=5
思考工具(无提示) 0.812 0.735 0.685 0.650 0.626
扩展思维 0.770 0.681 0.623 0.581 0.548
基线 0.783 0.695 0.643 0.607 0.583

主要发现:

  • 3.7%的改善 通过^1指标,无需额外提示
  • 展示在不同复杂程度上的有效性
  • 在多次试验中保持一致的性能提升

SWE试验台结果

SWE Bench评估现实世界软件工程任务的编码性能。思考工具帮助Claude 3.7 Sonnet实现了最先进的性能。

性能影响:

  • 基线得分:62.3%(没有思考工具)
  • 使用Think Tool:64.9%(基于1.6%的改善估计)
  • 统计学显著性韦尔奇t检验:t(38.89)=6.71,p<0.001,d=1.47
  • 样本量:30个样本使用think工具,144个样本不使用

性能洞察

当Think Tool表现出色时

  1. 政策密集型环境:当需要遵守复杂的规则时,可提高54%
  2. 顺序决策:当每项行动都建立在先前行动的基础上时,都会取得重大进展
  3. 刀具输出分析:处理多个工具调用的结果时性能得到增强
  4. 复杂域导航:在具有挑战性的领域(航空公司与零售)获得更大的利益

优化因素

  1. 特定域提示:针对特定用例量身定制的示例大大提高了效率
  2. 复杂性相关性:更复杂的领域从结构化思维中获益更多
  3. 一致性改进:在多次试运行中保持了效益,表明了稳健性
  4. 误差减少:帮助LLM更有效地处理边缘情况和异常情况

比较分析

方法 航空公司领域(k=1) 零售领域(k=1) 实施工作
基线 0.332 0.783 无
扩展思维 0.412(+24%) 0.770(-1.7%) 依赖于平台
思考工具 0.404(+22%) 0.812(+3.7%) 最小化
Think+优化提示 0.584 (+76%) 无 低

关键要点:think工具以最小的实现开销提供了实质性的性能改进,使其成为在复杂推理场景中增强LLM能力的绝佳选择。

📦 安装

npx快速入门(推荐)

最快的入门方法:

npx -y think-tool-mcp

全球安装

对于跨项目的持久使用:

npm install -g think-tool-mcp

本地开发安装

为了促进或地方发展:

git clone https://github.com/abhinav-mangla/think-tool-mcp.git
cd think-tool-mcp
npm install
npm run build
npm start

🎯 使用示例

复杂问题解决

Human: Help me optimize our company's supply chain with 5 warehouses and 12 retail locations.

LLM: I'll help you optimize your supply chain. Let me think through this systematically.

[Uses think tool]
Thought: This is a complex optimization problem requiring:
1. Analysis of warehouse-retail location distances
2. Shipping cost calculations between all pairs
3. Delivery time constraints evaluation
4. Inventory capacity considerations
5. Demand pattern analysis

I need to formulate this as a linear programming problem and consider both cost minimization and delivery time constraints...

[Proceeds with structured solution based on analysis]

政策遵守

Human: Can I return this opened product after 45 days without a receipt?

LLM: Let me carefully check our return policy.

[Uses think tool]
Thought: Analyzing this return request:
- Item: 45 days old (exceeds standard 30-day window)
- No receipt available
- Package opened

Policy considerations:
- Standard returns require 30 days + receipt
- Store credit might be possible with purchase verification
- Product category affects policy (electronics vs. clothing)
- Loyalty members may have extended windows
- Manager override possibilities

[Provides policy-compliant response with available options]

多工具分析

Human: Find inactive premium users (60+ days) and create a re-engagement campaign.

LLM: I'll search the database and create a targeted campaign.

[Runs database queries]
[Uses think tool]
Thought: Query results show 342 inactive premium users. Key patterns:
- 45% are in 6-12 month subscription cohort
- 72% last activity was "viewed dashboard"
- Only 8% used newest features
- 28% had support tickets before going inactive

Campaign strategy:
- Segment users by usage patterns
- Highlight unexplored features
- Address support-related pain points
- Personalize incentives based on history

[Creates targeted email campaign based on analysis]

🔧 api参考

可用工具

think

为LLM提供了一个用于复杂推理和分析的专用空间。

参数:

  • thought (字符串,必填):要记录的思维过程、推理或分析

说明: 思维工具接受法学硕士需要执行的任何结构化思维。这可能包括:

  • 逐步问题分析
  • 策略验证工作流
  • 多准则决策
  • 来自多个来源的信息综合
  • 复杂的推理链

使用模式: LLM在需要进行复杂推理时会自动使用此工具。该工具不会检索新信息或进行更改,它只是为结构化思维提供了一个空间。

🏗️ 发展

项目结构

think-tool-mcp/
├── src/
│   ├── index.ts          # CLI entry point
│   └── server.ts         # MCP server implementation
├── examples/
│   └── example_usage.md  # Usage examples
├── dist/                 # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

从源头构建

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

# Start the built server
npm start

贡献

欢迎投稿!请随时提交拉取请求。对于重大更改,请先打开一个问题来讨论您想要更改的内容。

  1. 复刻仓库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

📋 需求

  • Node.js:版本16或更高
  • npm:附带Node.js
  • MCP兼容平台:光标、克劳德桌面或其他支持MCP的应用程序

🔍 故障排除

常见问题

服务器未启动:

  • 确保已安装Node.js 16+
  • 检查MCP配置中的命令路径是否正确
  • 验证不存在端口冲突

工具未出现在AI平台中:

  • 确认MCP服务器配置正确
  • 配置更改后重新启动AI平台
  • 检查特定于平台的MCP文档

权限错误:

  • 在Unix系统上,确保二进制文件可执行
  • 尝试使用 npx 而不是全局安装

调试模式

用于开发和调试:

npm run dev

这直接使用TypeScript运行服务器,并提供更详细的错误信息。

📚 了解更多

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

👤 作者

阿比纳夫·曼格拉

🙏 致谢

  • 思维工具研究与方法论的人类学
  • 优秀框架的模型上下文协议团队
  • 开源社区的贡献和反馈

Enhancing AI reasoning, one thought at a time.