argus-decision-mcp

Argus Decision MCP

英語 | 한국어

Argus は、重要な判断を会話をまたいで引き継ぎます。ユーザーが採用した予測、現実に何が示されるべきか、いつ振り返るか、そして実際に何が起きたかを記録します。その結果は、次の判断のコンテキストになります。Argus は人を評価したり、判定をでっち上げたりすることはありません。

Argus の一部です · ウェブアプリは argus.voyage · MIT ライセンスです。

使用時のイメージ

普段どおり会話してください。Argus は、検証可能な項目を1つ記録するか尋ね、現実が答えを示せる頃にそれを再び提示します。

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 のエリシテーションを有効にして再試行してください。

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 では、connect を実行する代わりに、ウェブアプリの設定ページで取得した同期トークンを ARGUS_TOKEN に設定してください。認証情報がない場合、同期は何もせずに終了し、ローカルの記録には影響しません。

データについて

記録は .argus/ 内の追記専用のプレーンファイルです。データはあなたのものです。バックアップするにはこのフォルダーをコピーし、削除するにはこのフォルダーを削除してください。 サーバーをアンインストールしても、このフォルダーには触れません。

移動やワークツリーをまたいで存続するホーム台帳のために、CLI には archive-export、archive-restore、local-purge もあります。いずれも明示的な引数が必要です。--repository-id、絶対パスの --archive-dir、そして削除を実行する前の --confirm-repository の完全一致が必要です。これは意図的な仕様です。判断記録の消去が、ひとことのコマンドだけで実行されてはなりません。引数なしで実行すると、必要な引数が表示されます。

ツール

呼び出し可能な機能は、次の 6 つのツールです。

ツール	目的
argus_capture	判断と、ユーザーが所有するその背景情報を記録します。
argus_predict	反証可能な主張と、その確認日を 1 件記録します。
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

公開パッケージには、バンドルされたランタイムのエントリーポイントが1つ含まれています。内部実装と実験的なモジュールは、個別に呼び出し可能なファイルまたはインポート可能なファイルとしては提供されません。

報告方法と信頼境界の詳細については、SECURITY.mdを参照してください。