argus-decision-mcp

Argus Decision MCP

English | 한국어

Argus 会在不同对话中延续一项影响重大的决策：用户采纳的预测、现实应呈现的情况、何时回来查看，以及实际发生了什么。结果会成为下一次判断的上下文。Argus 不会给人打分，也不会凭空编造结论。

属于 Argus · Web 应用：argus.voyage · 基于 MIT 许可。

使用体验

你正常交谈。Argus 会提议记下一件可验证的事情，并在现实能够给出答案时带它回来。

2026-08-19
you    We're going with Postgres over DynamoDB — the join patterns kill us otherwise.

       ┌ Save this as a prediction?          (your host renders the form)
       │ "Postgres handles our join patterns without a read-replica through Q4"
       │ check by 2026-10-01
       └ accept as written · edit the wording or the date · decline

… six weeks later, in a different conversation …

2026-10-01
argus  One check is due — you saved this on 2026-08-19:
       "Postgres handles our join patterns without a read-replica through Q4"
       What actually happened?

you    We added a read replica in September. Analytics queries, not joins.

       Recorded. The original sentence stays exactly as you wrote it, your
       answer is appended next to it, and nothing is scored.

未经你同意，不会保存任何内容；Argus 也绝不会替你填写结果。

安装

要求： Node.js 18 或更高版本——经测试的版本是 Node 20 LTS（node --version；从 nodejs.org 获取）。无需 API 密钥，也无需账户：从首次调用起，记录就保存在本地文件中。

选择你的宿主。以下所有方式安装的都是同一个服务。

Claude Code

该插件会为你配置此服务，并在此基础上添加决策命令：

/plugin marketplace add commet/Argus
/plugin install argus@argus

重启 Claude Code，然后运行 /argus:settings doctor 确认配置无误。

只想安装服务，不需要命令？直接添加：

claude mcp add argus -- npx -y argus-decision-mcp          # this project only
claude mcp add -s user argus -- npx -y argus-decision-mcp  # every project

claude mcp add 默认使用当前项目——如果希望在所有地方使用 Argus，请添加 -s user。

Claude Desktop

打开 Settings → Developer → Edit Config，即可直接编辑配置文件。文件位置：

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows — %APPDATA%\Claude\claude_desktop_config.json

将 Argus 添加到配置中，然后彻底退出 Claude Desktop 并重新打开（仅关闭窗口并不够）：

{
  "mcpServers": {
    "argus-decision": {
      "command": "npx",
      "args": ["-y", "argus-decision-mcp"],
      "env": {
        "ARGUS_DIR": "/absolute/path/to/where/records/should/live/.argus"
      }
    }
  }
}

这里的 ARGUS_DIR 也是可选的——桌面应用没有“当前项目”，因此默认会将记录保存到你的个人主目录账本（~/.argus），而不是分散存放。需要将记录放在特定位置时再设置它。在 Windows 上，请转义反斜杠（"C:\\Users\\you\\decisions\\.argus"）。

Windows：服务未显示

• 先手动运行命令。在普通终端中运行 npx -y argus-decision-mcp 会打印简短的帮助卡片并退出——这表示二进制文件运行正常（助手会通过管道启动它，让它以服务形式持续运行）。如果崩溃或输出错误文本而不是帮助卡片，才是真正的问题。
• 如果 npx 运行失败，但在终端中可以正常工作，通常意味着 npm 未全局安装。检查 %APPDATA%\npm 是否存在；如果不存在，请运行 npm install -g npm。
• 如果日志提到未展开的 ${APPDATA}，请在上方的 env 块中添加 "APPDATA": "C:\\Users\\you\\AppData\\Roaming\\"。
• 日志位置：%APPDATA%\Claude\logs\mcp*.log（macOS：~/Library/Logs/Claude）。

Codex（CLI 或应用）

codex mcp add argus-decision -- npx -y argus-decision-mcp
codex mcp list        # argus-decision should be listed and enabled

之后重启 Codex。在运行 mcp add 前就已打开的对话不会获得新注册的工具——请退出并重新打开应用，或启动新的 CLI 会话。

Codex：未显示确认表单

Argus 会在保存预测前，通过一键表单进行确认。Codex 会根据默认的审批策略呈现该表单。如果你的策略是 never，或者 approval_policy.granular.mcp_elicitations = false，Codex 会直接返回协议 decline，而不会显示表单。MCP 没有提供标记来区分这种策略响应和快速的主动拒绝，因此 Argus 必须将其视为拒绝。如果你希望显示表单，请启用 MCP elicitation 并重试。

由 AI 起草的前提支持通过聊天确认：当确认窗口无法联系到你时，草稿会在响应中返回；你在对话中批准后，助手会再次调用并传入 chat_confirmed: true 来记录。无论哪种方式，来源信息都保持为 ai_surfaced。

### 其他 MCP 宿主

{
  "mcpServers": {
    "argus-decision": {
      "command": "npx",
      "args": ["-y", "argus-decision-mcp"],
      "env": {
        "ARGUS_DIR": "/absolute/path/to/your/project/.argus"
      }
    }
  }
}

只需安装一次；无需手动更新。不要指定版本，如上所示——npx 每次启动都会重新解析不带版本号的软件包名称，因此每个会话都会运行当前构建版本。

为什么不使用版本范围——以及这为何重要

不要写类似 @^2 的版本范围。只要 npx 缓存中已有满足范围的版本，就会直接使用它，而不会再次查询注册表；因此，即使一切看起来正常，通信也可能连续数周停留在旧构建版本。以下是 2026-07-29 的测量结果：两次使用相同的规格字符串，缓存中保留着一个版本较旧、但仍满足该范围的构建版本：

规格	启动的版本
argus-decision-mcp	当前发布版本
argus-decision-mcp@^2.0.0	缓存中的旧构建版本

精确锁定版本是正确做法，但之后会一直停留在该版本，直到有人手动修改。如果需要确认实际响应的是哪个构建版本，argus_check_in 会报告当前运行的版本（data.server_version）。

记录存储位置

首次调用时，记录就会保存在你的磁盘上——无需进行任何设置。

ARGUS_DIR 是可选项。默认位置遵循一条规则——项目证据决定账本的存放位置：

• 工作目录位于 git 仓库内，或已经包含 .argus 文件夹 → <that-project>/.argus（按项目隔离，保持不变）
• 否则（临时文件夹，或每次对话都会新建文件夹的应用——Codex 桌面应用就是如此）→ 个人主目录账本（~/.argus），这样记录会跨对话累积，而不会零散地留在各个对话的文件夹中

每次调用时指定的绝对路径 argus_dir 会覆盖所有设置；ARGUS_DIR 会覆盖上述规则。

Argus 不会扫描其他项目。现有的主目录级账本不会自动迁移或合并；如需查看，请显式将 ARGUS_DIR 指向该账本。

可选：账号同步

默认关闭，只有启用后才会开启。在浏览器中批准之前，不会有任何数据离开你的设备：

npx argus-decision-mcp connect       # one browser approval, credential stored locally
npx argus-decision-mcp disconnect    # revoke it here

在没有浏览器的机器上添加 --headless，即可使用设备验证码流程。对于 CI，请将 Web 应用设置页面中的同步令牌设为 ARGUS_TOKEN，而不是运行 connect。如果没有凭据，同步会静默跳过——本地记录不受影响。

你的数据

记录是 .argus/ 下仅追加的纯文本文件。它们属于你：**复制该文件夹即可备份，删除该文件夹即可移除数据。**卸载服务不会触碰这些文件。

对于可跨迁移和工作树保留的持久主目录，CLI 还提供 archive-export、archive-restore 和 local-purge。每条命令都需要明确提供参数——--repository-id、绝对路径 --archive-dir，以及逐字填写的 --confirm-repository——之后才会删除任何内容。这是有意设计的：清除判断记录不应只需输入一个词。若不带参数运行命令，它会指出需要哪个参数。

工具

完整的可调用工具共六个：

工具	用途
argus_capture	记录一项决策及其由用户提供的上下文。
argus_predict	记录一项可证伪的预测及其核查日期。
argus_check_in	读取当前需要关注的记录。
argus_resolve	追加一项由用户明确说明的结果。
argus_patterns	读取决策、凭据、时间线和模式。
argus_settings	读取或更新语言、提醒和显式同步设置。

2.0 之前版本中的名称不是可调用别名。缓存的调用若使用这些名称之一，会返回 UNKNOWN_TOOL，因此宿主不会意外地继续使用过时的接口约定。

设计边界

• 本地优先，仅追加记录。
• 默认按项目隔离。
• 用户措辞和 AI 提取的措辞保留不同的来源信息。
• 记录的文本均视为不可信数据。
• 不提供评判、评分、准确率得分、连续记录或排行榜。
• 网络同步需显式启用；除非设置 ARGUS_TELEMETRY=1，否则匿名遥测默认关闭。
• 意外错误会记录在服务端，并以通用消息返回，避免向模型泄露路径或堆栈信息。

开发

npm install
npm run typecheck
npm test
npm run build
npm pack --dry-run

发布的包仅包含一个打包后的运行时入口。内部实现和实验性模块不会作为独立的可调用文件或可导入文件发布。

有关报告方式和信任边界的详细信息，请参阅 SECURITY.md。