clear-thought-mcp-server

🚀 清晰思维MCP服务器

清晰思维MCP服务器是一个模型上下文协议（MCP）服务器，它提供系统思维、心智模型和调试方法，以增强问题解决能力。

🚀 快速开始

前提条件

• Node.js 18.x 或更高版本
• npm 9.x 或更高版本

安装

通过Smithery安装

要通过 Smithery 自动为Claude桌面版安装清晰思维MCP服务器，请运行以下命令：

npx -y @smithery/cli install @chirag127/clear-thought-mcp-server --client claude

手动安装

1. 克隆仓库：

git clone https://github.com/chirag127/clear-thought-mcp-server.git

然后进入项目目录：

cd clear-thought-mcp-server

2. 安装依赖：

npm install

3. 构建项目：

npm run build

运行服务器

使用以下命令启动服务器：

npm start

这将使用标准输入输出传输启动MCP服务器，MCP客户端可以连接到该服务器。

开发模式

若要在开发时实现自动重新加载，请运行：

npm run dev

与MCP客户端一起使用

该服务器可以与任何兼容MCP的客户端一起使用。以下是一些示例：

与MCP检查器一起使用

1. 安装MCP检查器：

npm install -g @modelcontextprotocol/inspector

2. 运行服务器：

npm start

3. 在另一个终端中，连接检查器：

mcp-inspector --stdio "node dist/index.js"

与大语言模型（LLM）应用程序一起使用

该服务器可以集成到支持模型上下文协议的大语言模型应用程序中。具体的集成细节请参考MCP文档。

✨ 主要特性

心智模型

• 第一性原理思维
• 机会成本分析
• 错误传播理解
• 橡皮鸭调试法
• 帕累托原则
• 奥卡姆剃刀原理

设计模式

• 模块化架构
• API集成模式
• 状态管理
• 异步处理
• 可扩展性考虑
• 安全最佳实践
• 自主设计模式

编程范式

• 命令式编程
• 过程式编程
• 面向对象编程
• 函数式编程
• 声明式编程
• 逻辑编程
• 事件驱动编程
• 面向切面编程
• 并发编程
• 响应式编程

调试方法

• 二分查找法
• 逆向工程
• 分治法
• 回溯法
• 原因消除法
• 程序切片法

顺序思维

• 结构化思维过程
• 支持修订和分支
• 进度跟踪
• 上下文维护

协作推理

• 多人协作解决问题
• 整合不同专业知识
• 结构化辩论和达成共识
• 观点综合

决策框架

• 结构化决策分析
• 多种评估方法
• 标准权重分配
• 处理风险和不确定性

元认知监控

• 知识边界评估
• 主张确定性评估
• 推理偏差检测
• 信心校准
• 不确定性识别

科学方法

• 结构化假设检验
• 变量识别
• 预测制定
• 实验设计
• 证据评估

结构化论证

• 形式辩证推理
• 正题-反题-合题
• 论点强度分析
• 前提评估
• 逻辑结构映射

视觉推理

• 图表表示
• 视觉问题解决
• 空间关系分析
• 概念映射
• 视觉洞察生成

📦 工具选择指南

清晰思维MCP服务器中的每个工具都有其特定的优势。以下是每个工具可能特别有用的一些场景：

心智模型

最适合用于：

• 初步理解问题
• 分解复杂系统
• 分析权衡
• 寻找根本原因
• 做出战略决策

示例场景：

• 分析系统架构选择
• 评估竞争解决方案
• 理解错误模式

设计模式

最适合用于：

• 实施经过验证的解决方案
• 构建新功能
• 确保代码可维护性
• 扩展应用程序
• 管理技术债务

示例场景：

• 构建新的系统组件
• 重构现有代码
• 实施横切关注点

编程范式

最适合用于：

• 选择合适的编码方法
• 理解语言优势
• 针对特定问题类型进行优化
• 平衡实现中的权衡

示例场景：

• 在面向对象编程和函数式编程方法之间进行选择
• 实现并发系统
• 设计响应式应用程序

调试方法

最适合用于：

• 解决问题
• 性能优化
• 系统分析
• 错误解决
• 质量保证

示例场景：

• 修复生产问题
• 优化缓慢的流程
• 解决集成问题

顺序思维

最适合用于：

• 解决复杂问题
• 多步骤分析
• 决策细化
• 流程改进
• 全面规划

示例场景：

• 规划主要功能
• 分析系统范围的更改
• 做出架构决策

协作推理

最适合用于：

• 复杂、多方面的问题
• 需要不同专业知识的情况
• 有争议或高风险的决策
• 创新和构思

示例场景：

• 架构设计决策
• 产品战略制定
• 风险评估和缓解

决策框架

最适合用于：

• 在多个选项之间进行结构化选择
• 考虑风险的决策制定
• 多标准评估
• 涉及利益相关者的决策

示例场景：

• 技术选择
• 资源分配
• 战略规划

元认知监控

最适合用于：

• 评估知识边界
• 评估主张的确定性
• 检测推理偏差
• 校准信心
• 识别不确定性领域

示例场景：

• 评估在不熟悉领域的专业知识
• 评估预测的信心
• 识别分析中的潜在偏差
• 确定何时寻求更多信息

科学方法

最适合用于：

• 系统的假设检验
• 实证研究
• 因果分析
• 基于证据的推理
• 迭代改进理解

示例场景：

• 研究系统行为
• 测试因果关系
• 评估竞争解释
• 设计对照实验

结构化论证

最适合用于：

• 形式辩证推理
• 分析复杂辩论
• 评估竞争立场
• 综合不同观点
• 构建逻辑论证

示例场景：

• 评估论点的强度
• 识别逻辑谬误
• 构建有说服力的案例
• 解决冲突观点

视觉推理

最适合用于：

• 空间问题解决
• 概念映射
• 模式识别
• 关系可视化
• 复杂系统建模

示例场景：

• 绘制系统架构图
• 可视化数据关系
• 映射概念空间
• 创建视觉解释

注意：这些只是建议，而非规则。工具可以按照最适合您需求的任何顺序或组合使用。

🔧 技术细节

项目结构

clear-thought-mcp-server/
├── dist/               # 编译后的JavaScript文件
├── src/                # TypeScript源代码
│   ├── models/         # 数据接口
│   ├── tools/          # 工具实现
│   └── index.ts        # 服务器主入口点
├── package.json        # 项目依赖和脚本
├── tsconfig.json       # TypeScript配置
└── README.md           # 项目文档

技术栈

• TypeScript
• Node.js
• 模型上下文协议SDK
• Zod（用于验证）

📄 许可证

本项目采用MIT许可证。

👨‍💻 作者

Chirag Singhal (@chirag127)