聪明的思维
Smart Thinking是一个模型上下文协议(MCP)服务器,它提供基于图的多步推理,而不依赖于外部AI API。一切都在本地发生:相似性搜索、基于启发式的评分、验证跟踪、内存和可视化都在一个为透明度和可重复性而设计的确定性管道中运行。
核心能力
- 图优先推理,将思想与丰富的关系(支持、矛盾、精炼、上下文链接等)联系起来。
- 本地TF-IDF+余弦相似性引擎支持内存查找和图扩展,无需第三方嵌入服务。
- 启发式质量评估,使用透明规则而不是LLM调用对置信度、相关性和质量进行评分。
- 验证工作流程,包括详细的状态和对表面事实、护栏和不确定性的计算跟踪。
- 可以跨运行恢复的持久会话,使推理图和验证分类账保持同步。
推理流程
- 会话引导 –
ReasoningOrchestrator初始化会话,恢复任何已保存的图形状态,并准备功能标志。 - 预验证 –确定性警卫检查传入的想法,执行轻量级计算检查,并注释有效载荷。
- 图形集成 –思想被插入
ThoughtGraph,链接到上下文、先前的想法和相关的记忆。 - 启发式评估 –
QualityEvaluator和MetricsCalculator计算解释决策路径的加权分数和轨迹。 - 验证反馈 –状态来自
VerificationService并且启发式跟踪被附加到节点并在连接之间传播。 - 坚持与回应 –更新将写入
MemoryManager/VerificationMemory,并返回结构化的MCP响应以及推理步骤的时间线。
每个步骤都记录了结构化元数据,因此您可以确定地可视化推理结构、审计决策和回放会话。
安装
Smart Thinking是一个与Windows、macOS和Linux兼容的npm包。
全局安装(推荐)```bash
npm install -g smart-thinking-mcp
### 使用npx运行```bash
npx -y smart-thinking-mcp
来源```bash
git clone https://github.com/Leghis/Smart-Thinking.git
cd Smart-Thinking
npm install
npm run build
npm link
> 需要特定于平台的配置详细信息吗?看 `GUIDE_INSTALLATION.md` 有关Windows、macOS、Linux和Claude Desktop集成的分步说明。
## 快速浏览
- `smart-thinking-mcp` --启动MCP服务器(全局安装的软件包)。
- `npx -y smart-thinking-mcp` --无需全局安装即可启动。
- `npm run start` --从源代码执行构建的服务器。
- `npm run demo:session` --运行内置的CLI演练,通过推理管道提供示例想法并打印结果时间线。
演示脚本展示了编排器如何逐步添加节点、评估启发式方法并记录验证反馈。
## MCP客户端兼容性
Smart Thinking在最流行的MCP客户端和操作系统中得到了验证。使用新的连接器模式(`--mode=connector` 或 `SMART_THINKING_MODE=connector`)当客户端只接受 `search` 和 `fetch` ChatGPT连接器所需的工具。\[^openai mcp\]
|客户|运输|注意事项|
| --- | --- | --- |
| **ChatGPT连接器和深度研究** |HTTP+SSE |使用部署 `SMART_THINKING_MODE=connector node build/index.js --transport=http --host 0.0.0.0 --port 8000`.将ChatGPT指向 `https:///sse` 只保留 `search`/`fetch` 启用,与OpenAI的远程MCP指导保持一致。\[^openai mcp\]|
| **OpenAI Codex CLI和代理SDK** |流式HTTP/SSE |配置Codex代理 `http://localhost:3000/mcp` 或 `http://localhost:3000/sse` 并设置 `SMART_THINKING_MODE=connector` 当只需要知识检索时。\[^奥派代理商\]|
| **克劳德桌面/克劳德代码** |stdio |添加 `"command": "smart-thinking-mcp"` (或 `npx` 命令) `claude_desktop_config.json`。完整的工具集可用。\[^mcp客户\]|
| **光标IDE** |stdio/SSE/流式HTTP |将服务器添加到 `~/.cursor/mcp.json` 或项目 `.cursor/mcp.json`。Cursor支持提示、根、启发和流。\[^光标mcp\]|
| **Cline(VS代码)** |stdio |将命令放入 `~/Documents/Cline/MCP/smart-thinking.json` 或者使用应用内市场注册工具集。\[^mcp客户\]|
| **基洛代码** |stdio |通过MCP市场注册并在本地运行服务器;Smart Thinking为自主编辑提供了确定性工具。\[^mcp客户\]|
> 需要最小的部署占用空间?合并 `--transport=http --mode=connector` 使用反向代理(ngrok、fly.io、render等),远程客户端可以在不暴露完整工具集的情况下使用服务器。
对于注册表扫描程序和回退元数据提取,Smart Thinking还公开了:
- `GET /.well-known/mcp/server-card.json`
## 配置和功能标志
- `feature-flags.ts` 切换高级行为,如外部集成(默认禁用)和详细跟踪。
- `config.ts` 对齐平台特定的路径和验证阈值。
- `memory-manager.ts` 和 `verification-memory.ts` 使用确定性JSON快照存储会话图、度量和计算结果。
## 零-API-Key模式(默认)
- Smart-Thinking完全以本地确定性模式运行,无需任何API密钥。
- 默认情况下,在中禁用外部验证/搜索连接器 `ToolIntegrator`.
- 要明确启用外部连接器,请设置:```bash
export SMART_THINKING_ENABLE_EXTERNAL_TOOLS=true
- 如果禁用外部连接器(默认),验证建议将保留在本地(
executePython,executeJavaScript)外部工具调用返回本地回退结果。 FeatureFlags.externalLlmEnabled和FeatureFlags.externalEmbeddingEnabled默认情况下保持禁用状态,因此不需要远程LLM/嵌入提供程序。
开发流程```bash
npm run build # Compile TypeScript sources
npm run lint # ESLint across src/
npm run test # Jest test suite
npm run test:coverage # Jest coverage report
npm run watch # Incremental TypeScript compilation
```
看 docs/modernisation-smart-thinking-v12-plan.md 用于现代化检查表和推出跟踪。
质量与支持
- 确定性启发式和验证消除了对远程LLM的依赖。
- 最新验证(2026年2月6日):
80.47%声明,81.59%线,84.34%功能,63.48%分支。 - CI建议:运行
npm run lint和npm run test:coverage在每个候选发布之前。
贡献
欢迎捐款。请打开一个描述更改的问题或拉取请求,并在提交之前运行上述质量检查。
许可证
麻省理工学院
[^openai-mcp]:openai,“为ChatGPT和API集成构建mcp服务器”,强调连接器需要 search 和 fetch 远程使用的工具。 (https://platform.openai.com/docs/mcp)
[^openai代理]:关于MCP传输(stdio、SSE、流式HTTP)的openai代理SDK文档。 (https://openai.github.io/openai-agents-python/mcp/)
[^mcp客户端]:模型上下文协议客户端目录,列出了Claude、Cline、Kilo Code和其他mcp兼容应用程序。 (https://modelcontextprotocol.io/clients)
[^cursor mcp]:用于通过stdio/SSE/HTTP传输配置mcp服务器的游标文档。 (https://cursor.com/docs/context/mcp)
