AI导哈

结构化推理工具

Atom of Thoughts 是一个为大型语言模型设计的结构化推理工具，能够分解问题、跟踪置信度、可视化推理过程并支持审批，适用于决策支持、架构规划和问题调试等场景。

  • by dioptx
  • TypeScript
  • 本地部署
  • 95 星标
  • 更新于
在 GitHub 查看 dioptx/mcp-atom-of-thoughts

使用说明

思想的原子

LLM的结构化推理。分解、跟踪信心、可视化、批准。

快速入门

1. 添加到MCP配置中：

{
  "mcpServers": {
    "atom-of-thoughts": {
      "command": "npx",
      "args": ["-y", "@dioptx/mcp-atom-of-thoughts"]
    }
  }
}

2. 重新启动客户端。

3. 让模型推理：

“使用AoT-fast来思考我们是否应该为API使用JWT或基于会话的身份验证。”

该模型将问题分为五种原子（前提、推理、假设、验证、结论），每种原子都标有置信度得分。你得到的是一个可以审计的结构化链，而不是一个黑箱答案。

[！提示] 适用于Claude Code、Cursor、Windsurf或任何支持MCP的客户端。

安装

新巴拿马型船舶 （推荐；零安装，始终最新）

{ "command": "npx", "args": ["-y", "@dioptx/mcp-atom-of-thoughts"] }

npm全局

npm install -g @dioptx/mcp-atom-of-thoughts

{ "command": "mcp-atom-of-thoughts" }

史密瑟里

npx -y @smithery/cli install @dioptx/mcp-atom-of-thoughts --client claude

码头工人

docker build -t aot .

{ "command": "docker", "args": ["run", "-i", "--rm", "aot"] }

运作原理

graph LR
    P["P · Premise"]:::premise --> R["R · Reasoning"]:::reasoning
    R --> H["H · Hypothesis"]:::hypothesis
    H --> V["V · Verification"]:::verification
    V --> C["C · Conclusion"]:::conclusion

    classDef premise fill:#6b7280,stroke:#9ca3af,color:#fff,font-weight:bold
    classDef reasoning fill:#3b82f6,stroke:#60a5fa,color:#fff,font-weight:bold
    classDef hypothesis fill:#eab308,stroke:#facc15,color:#000,font-weight:bold
    classDef verification fill:#06b6d4,stroke:#22d3ee,color:#fff,font-weight:bold
    classDef conclusion fill:#22c55e,stroke:#4ade80,color:#fff,font-weight:bold

原子通过依赖关系链。每个都有一个从0到1的置信度得分。当得出高置信度结论或达到最大深度时，推理终止。每个问题都在自己的会话中运行，所以两条思路永远不会相互渗透。

工具

三个工具覆盖整个表面：

工具 何时伸手去拿
AoT-fast 默认值。权衡、调试、决策、选项评估。深度3。
AoT-full 计划、架构、分解为子问题。深度5。
atomcommands 会话、导出、审批轮询、分解生命周期。

快速示例

AoT-fast({atomId:"P1", content:"API returns 500 on POST /users",     atomType:"premise"})
AoT-fast({atomId:"R1", content:"Unhandled exception in route handler", atomType:"reasoning", dependencies:["P1"]})
AoT-fast({atomId:"C1", content:"Add try-catch in POST handler",       atomType:"conclusion", dependencies:["R1"], confidence:0.9})

仅 atomId, content，以及 atomType 是必需的。其他一切都有合理的违约。

可视化

通过 viz: true 在浏览器中打开交互式D3图的任何调用中：

AoT-fast({atomId:"C1", ..., viz: true})

通过HTTP将批准和拒绝决定POST回服务器。没有文件系统轮询。

实时TUI

在第二个终端窗格中观察模型原因，并将批准/拒绝决定反馈到下一个工具调用中。默认情况下，事件提要处于打开状态；无需额外配置。

在LLM客户端旁边的第二个窗格中：

npx -y @dioptx/mcp-atom-of-thoughts tui

1.观察推理过程

原子在模型发射时出现，遵循链式前提→ 推理→ 假设→ 验证→ 结论。置信条实时填充，依赖关系显示为内联箭头，速度火花线跟踪事件发生率。自动滚动使最新的原子保持选中状态。

2.提供细致的反馈

j / k 移动所选内容。 a 接受一个原子； * 将其作为关键背景； r 拒绝它并提示一行原因。 s 提交判决书。提交闪光告诉你下一步该做什么：让模特打电话 atomcommands check_approval该判决被写为与现有文件回退路径已经轮询的JSON相同的批准，因此反馈通过服务器已经理解的合同返回。 零新线协议。

3.自定义视图

t 打开设置：隐藏低置信度原子的置信度阈值、颜色主题（鲜艳、柔和或单色）、紧凑模式、依赖箭头切换。 ? 显示了完整的密钥映射。

密钥参考

关键 行动
j / k 移动选择
a 接受所选原子
r 拒绝（提示一行原因）
u 对所选原子的明确反馈
* 明星作为关键背景
s 提交裁决（书面 aot-approval-*.json)
t 设置（阈值、主题、紧凑模式、deps）
? 钥匙帮助
space 暂停/恢复事件流
q 退出

[！提示] 跳过安装程序并查看其运行情况： npx -y @dioptx/mcp-atom-of-thoughts tui --demo

Configuration 
{
  "args": ["-y", "@dioptx/mcp-atom-of-thoughts", "--mode", "fast", "--viz", "never"]
}
标志 默认值 效果
--mode full|fast|both both 注册哪些工具
--viz auto|always|never auto auto：渲染 viz:true. always：接听每一个电话。 never：跳过（CI）
--max-depth <n> 5/3 超过深度限制
--output-dir <path> OS temp 在哪里编写即HTML
--downloads-dir <path> ~/下载 批准JSON回退
Sessions

每个推理链都有自己的会话。默认ID: "default".

  • atomcommands new_session 创建并激活一个新的。
  • atomcommands switch_session / list_sessions / reset_session 为了管理。
  • 当推理终止时，会话会自动存档。下一个零依赖原子自动生成 default-2, default-3等等。
  • 或通过 sessionId 在任何AoT呼叫中明确地瞄准一个目标。

一个MCP进程中的两个问题在没有手动会话管理的情况下保持隔离。

Browser visualization (alternative to the TUI)

更喜欢浏览器选项卡而不是终端窗格？通过 viz: true 在任何AoT电话上。服务器写入一个自包含的HTML文件（D3内联，脱机工作）并打开它：

  • 带置信环的原子类型着色的力导向图
  • 侧栏用于批准或拒绝相或单个原子
  • 批准/拒绝本地POS 127.0.0.1 临时端口上的侦听器；回落到a ~/Downloads 如果侦听器无法绑定，则进行文件扫描

TUI和浏览器都是feed atomcommands check_approval。选择适合您工作流程的选项。

Install methods

新巴拿马型船舶 （零安装）：

{ "command": "npx", "args": ["-y", "@dioptx/mcp-atom-of-thoughts"] }

npm全局:

npm install -g @dioptx/mcp-atom-of-thoughts

史密瑟里:

npx -y @smithery/cli install @dioptx/mcp-atom-of-thoughts --client claude

码头工人:

docker build -t aot . && docker run -i --rm aot
Development 
git clone https://github.com/dioptx/mcp-atom-of-thoughts.git
cd mcp-atom-of-thoughts
npm install
npm test        # 183 tests (unit + e2e)
npm run build
Migrating from v2

看 MIGRATION_v2_to_v3.md 对于完整的查找表。简短版本：

  • AoT-light 现在是 AoT-fast
  • AoT 现在是 AoT-full
  • generate_visualization 现在是 viz: true 在任何AoT电话上
  • export_graph 和 check_approval 现在 atomcommands 子指令
  • --no-viz 和 --no-approval 被替换为 --viz auto|always|never

MIT。基于 思想的原子.

相关 MCP