克劳德·奥尔格·麦克普
A. 模型上下文协议（MCP） 服务器 计划推理总结 在 克劳德代码。将决策、权衡和假设作为可扫描的摘要呈现，以便您一眼就能纠正克劳德的推理。
______________________________________________________________________
克劳德对计划的推理是看不见的。当克劳德写一个计划时，它的决定、假设和权衡都埋在文件中。你必须通读全文才能找到它们。如果Claude采用了错误的方法或做出了糟糕的权衡，在实施过程中出现问题之前，你不会知道。
Augur读取计划结构并返回一个模板，Claude用其实际推理填充该模板，该模板嵌入响应中，而不是隐藏在折叠的工具结果中。您可以一目了然地看到决策、假设和权衡，并可以在编写一行代码之前对其进行纠正。
安装
要求：
来自shell：
claude mcp add claude-augur-mcp -- npx claude-augur-mcp从内部克劳德 （需要重新启动）：
Add this to our global mcp config: npx claude-augur-mcp
Install this mcp: https://github.com/Vvkmnn/claude-augur-mcp从任何手动配置 mcp.json：（光标、风帆等）
{
"mcpServers": {
"claude-augur-mcp": {
"command": "npx",
"args": ["claude-augur-mcp"],
"env": {}
}
}
}有 不 npm install 必需的：没有外部数据库，没有索引，只有Node.js内置的文件系统访问。
然而，如果 npx 解决错误的包，您可以使用以下命令强制解决：
npm install -g claude-augur-mcp特征
1个工具。计划结构提取。模板种子设定。内联渲染。
占卜_解释
阅读一个计划文件，并返回一个结构化模板供Claude填写其推理过程。克劳德呈现抽象 在其响应中内联，不会隐藏在折叠的工具结果中。
编写或编辑计划文件后致电：
augur_explain plan_path="/Users/you/.claude/plans/your-plan.md"MCP返回两个内容块：
块1：单行摘要，即使在工具结果折叠时也可见。
your-plan.md · 10/18 done块2：带有预渲染标题、进度和 [FILL] 标记。
┌ 📐 my-project · your-plan.md ────────────────────────────────────
│ Build a REST API with authentication, rate limiting,
│ and WebSocket support for real-time notifications.
│
├ Progress ───────────────────────────────────────────────────────
│ Done (10/18): Auth scaffold, Rate limiter + 1 more
│ Next: WebSocket layer + 1 more
│
├ Decisions ──────────────────────────────────────────────────────
│ [FILL: 2-4 decisions, format: "✓ choice — reason"]
│ [child decisions use: " └ choice — reason"]
│
├ Assumptions ────────────────────────────────────────────────────
│ [FILL: 1-2 assumptions, format: "? statement"]
│
├ Tradeoffs ──────────────────────────────────────────────────────
│ [FILL: 1-2 lines, "+" for pro, "−" for con]
│
├ Reasoning ──────────────────────────────────────────────────────
│ [FILL: 2-3 lines explaining WHY]
└──────────────────────────────────────────────────────────────────Claude内联填充模板：
┌ 📐 my-project · your-plan.md ────────────────────────────────────
│ Build a REST API with authentication, rate limiting,
│ and WebSocket support for real-time notifications.
│
├ Progress ───────────────────────────────────────────────────────
│ Done (10/18): Auth scaffold, Rate limiter + 1 more
│ Next: WebSocket layer + 1 more
│
├ Decisions ──────────────────────────────────────────────────────
│ ✓ Express over Fastify — team familiarity, middleware ecosystem
│ └ Passport.js for auth — proven, supports OAuth + JWT
│ ✓ Redis for rate limiting — atomic counters, TTL built-in
│ ✓ ws over Socket.io — lighter, no fallback polling needed
│
├ Assumptions ────────────────────────────────────────────────────
│ ? Single Redis instance sufficient for current scale
│ ? WebSocket clients handle reconnection gracefully
│
├ Tradeoffs ──────────────────────────────────────────────────────
│ + Redis rate limiting: sub-ms response, horizontal scaling
│ − Extra infrastructure dependency to operate
│
├ Reasoning ──────────────────────────────────────────────────────
│ Auth must be production-grade from day one — Passport.js
│ handles OAuth/JWT without custom crypto. Redis rate limiting
│ chosen over in-memory because the API will be multi-process.
│ ws chosen over Socket.io to avoid 200KB bundle overhead.
└──────────────────────────────────────────────────────────────────从计划文件中提取的内容：
| 字段 | 来源 | 示例 |
|---|---|---|
| 项目名称 | H1标题前 : | my-project |
| 目的 | 第一 **Primary goal**: 行，或第一段散文 | 全文，单词包装 |
| 章节 | H2标题（不包括 Detail: 部分） | Context, Architecture, ... |
| 进展 | ### Step N: 标题与 - [x] / - [ ] 计数 | Done (10/18): Auth, Rate limiter |
| 完成步骤 | 所有项目都已完成的步骤 [x] | 最多2个名字+ N more |
| 下一步 | 待处理项目的步骤 | 名字+ N more |
方法论
📐 claude-augur-mcp
━━━━━━━━━━━━━━━━━━━
Claude writes a plan
augur_explain
│
▼
┌─────────────────┐
│ read plan file │ from disk (read-only)
│ (session.ts) │
└────────┬────────┘
│
├── title → project name (before ":")
├── purpose → **Primary goal**: or first prose
├── sections → H2 headings
└── progress → ### Step N: with [x]/[ ] counts
│
┌────────▼────────┐
│ render template │ left-gutter format
│ (render.ts) │ [FILL] markers for Claude
└────────┬────────┘
│
┌────────────┴────────────┐
▼ ▼
block 1 block 2
summary template
(visible collapsed) (Claude renders inline)
│ │
▼ ▼
plan.md · 10/18 done ┌ 📐 project · plan.md ──
│ purpose...
├ Progress ────────────
│ Done (10/18): Auth + 1
├ Decisions ───────────
│ [FILL]
├ Assumptions ─────────
│ [FILL]
└──────────────────────
TEMPLATE SEEDING:
Regex extraction of Claude's thinking blocks produces garbage:
free-form prose has no structured patterns to match.
Augur takes a different approach: extract plan structure (the
deterministic part), seed a template, let Claude fill reasoning
(the part only Claude knows). Structure from MCP, content from
Claude. Consistent format, accurate reasoning.
MCP pre-renders Claude fills
────────────── ────────────
header + purpose decisions
progress counts assumptions
section labels tradeoffs
formatting rules reasoning双块返回：MCP工具结果在Claude Code UI中折叠。即使折叠，块1也是可见的单行摘要。块2是Claude在其响应中内联呈现的完整模板，用户无需展开即可看到。
只读: augur_explain 只读取计划文件。没有磁盘写入，没有状态，没有副作用。在计划模式下工作。
架构：
claude-augur-mcp/
├── package.json
├── tsconfig.json
├── src/
│ ├── index.ts # MCP server, 1 tool
│ ├── types.ts # PlanStructure interface
│ ├── session.ts # Plan file parser + step progress extractor
│ └── render.ts # Template generator with left-gutter format
└── demo/
├── demo.cast # asciinema recording
└── demo.gif # animated demo设计原则：
- 正则表达式提取上的模板种子：正则表达式对思维块产生垃圾；模板播种让Claude能够准确地完成自己的推理
- 内联过度折叠：工具结果在Claude Code UI中折叠；内联渲染使抽象保持可见
- 只读：无磁盘写入，无状态，在计划模式下工作
- 单一工具:
augur_explain把一件事做好；无CRUD、无存储、无洞察管理 - 左槽格式:
┌│├└没有右边框的垂直条；不能错位，在任何终端宽度上都能清晰地渲染 - 从不截断：目的和标题始终完整呈现；单词包装，永不剪切
设计影响：
- 架构决策记录：用于捕获具有上下文和后果的决策的结构化格式
- Y-Statement ADR变体：简明决策格式：“在上下文X中，面对Y，我们决定Z，接受C”
- 罗马 占卜师：解释符号和模式以揭示普通观察中隐藏的意义的牧师
发展
git clone https://github.com/Vvkmnn/claude-augur-mcp && cd claude-augur-mcp
npm install && npm run build脚本：
| 命令 | 描述 |
|---|---|
npm run build | TypeScript编译(tsc && chmod +x dist/index.js) |
npm run dev | 观看模式(tsc --watch) |
npm start | 运行MCP服务器(node dist/index.js) |
npm run clean | 删除构建工件(rm -rf dist) |
npm run typecheck | 无需发射的TypeScript验证 |
npm test | 类型检查 |
贡献：
- 分叉存储库并创建功能分支
- 遵循TypeScript严格模式 MCP协议 标准
从示例中学习：
- 官方MCP服务器 供参考实现
- TypeScript 软件开发工具包 最佳实践
- 用于npm包开发
许可证
_Augurs之墓，壁画（塔尔奎尼亚，约公元前530年）。克劳迪斯，皇帝、学者和奥古尔学院的成员，写道 蒂勒尼卡，一本丢失的20卷伊特鲁里亚文明史及其占卜方法。预兆的作用不是预测未来，而是解释迹象，揭示拟议的行动方案是否有价值。_