AgentGuard

@agentguard-run/mcp

MCP サーバーとしての AgentGuard®：AI エージェントのアクションに対するローカルの支出上限と Ed25519 署名付き来歴レシートを提供します。Claude Desktop、Claude Code、Cursor、Cline、または独自のエージェントランタイムなど、あらゆる Model Context Protocol ホストから利用できます。

データプレーンはありません。 ツールが受け取るのは、モデル名、トークン数、エンドポイント URL などのメタデータのみです。プロンプトと生成結果がこのサーバーを通過することはなく、その内容はお使いのマシン内に保持されます。レシートに内容は含まれません。

設定済みのライセンスでは、ライセンスおよびシートサービスを利用します。任意のアクティベーションテレメトリには同意が必要で、AGENTGUARD_NO_BEACON=1 で無効にできます。どちらの経路でも、プロンプト、ツールの内容、レシートが送信されることはありません。

インストール

{
  "mcpServers": {
    "agentguard": {
      "command": "npx",
      "args": ["-y", "@agentguard-run/mcp"]
    }
  }
}

任意の環境変数：

変数	デフォルト	意味
AGENTGUARD_MCP_DAILY_CAP_CENTS	500	1 日あたりのハード支出上限（超過時はブロック）
AGENTGUARD_MCP_PER_CALL_CAP_CENTS	100	1 回あたりのハード支出上限（超過時はブロック）
AGENTGUARD_MCP_TENANT	mcp-local	レシートに記録されるテナントスコープ
AGENTGUARD_HOME	~/.agentguard	署名鍵と判定台帳のディレクトリ
AGENTGUARD_MCP_LEDGER	ndjson	署名済みの判定を保存します。memory にするとプロセス内のみのストレージに戻ります
AGENTGUARD_MCP_DISABLE_COST_OVERRIDE	unset	1 にすると価格設定の上書きを破棄し、無効にします
AGENTGUARD_ACTOR_DIGEST	unset	1 にするとアクター ID の SHA-256 ダイジェストを保存します。プロバイダーは判読可能なままです

初回実行時に署名鍵ペアが生成され、<AGENTGUARD_HOME>/mcp-signing.json（0600）に保存されます。署名済み判定は公開検証鍵とともに<AGENTGUARD_HOME>/<tenant>/decisions.ndjsonに追記されます。エクスポートには以前のプロセス実行分も含まれ、新しい判定は既存のチェーンに追加されます。テナントディレクトリ名には、支出ストアのファイル名正規化が適用されます。以前のバージョンと同様、支出カウンターはプロセス内に保持されます。

すべてのツールで、識別子パラメーターとしてagent_id、task_id、workflow_idを任意で指定できます。spend_decideはこれらを呼び出しコンテキストに渡し、actor.agentId、actor.taskId、actor.workflowIdとして署名します。設定されたテナントはactor.tenantIdになります。他のツールでは、支出判定を記録せずにこれらのメタデータフィールドを受け付けます。プロンプト、任意のコンテンツ、認証情報、ファイルシステムのパスは ID として拒否されます。これらのパラメーターを指定しない既存の呼び出しも引き続き動作します。

ツール

• spend_decide：モデル呼び出しの実行前に判定します。許可／ブロックの結果と、モデルの識別情報、重みの原産国（GLM、DeepSeek、Qwen、Kimi など中国を原産とするファミリーは自動的にフラグ付けされます）、ホスティング管轄区域、データ保持方針を記録した、署名付きのハッシュチェーン・レシートを返します。認識されないエンドポイント（vLLM、Ollama、TGI、独自クラスター）は「セルフホスト可能」として扱われ、データ保持はゼロ、お客様の管轄区域となります。
• verify_receipt：任意のレシートを個別に検証します。署名されたバイトを 1 つでも変更すると、検証に失敗します。
• export_receipts：テナントの判定台帳を、以前のプロセス実行分も含め、検証済みハッシュチェーンとしてエクスポートします。メモリモードでは現在のプロセス分のみをエクスポートします。
• set_model_cost：セルフホストモデルの価格を登録します（AgentGuard は不明なコストをデフォルトで拒否します）。
• provenance_preview：支出することなく、モデル／エンドポイントに対して証明される内容を確認します。
• spend_status：有効な上限、テナント、判定件数、署名者のフィンガープリントを表示します。

導入の理由

エージェントがホスト型 API からセルフホストモデルに移行すると、プロバイダーとともに、プロバイダーの支出ダッシュボード、レート制限、監査ログも利用できなくなります。AgentGuard はそれらをローカルに復活させ、さらに、ホスト型プロバイダーが提供したことのないものを追加します。それは、お客様や当社を信頼しなくても第三者が検証できる暗号学的レシートです。

詳細：https://agentguard.run/sovereign/ および https://agentguard.run/sovereign/guide/

独立して検証する

レシートは https://agentguard.run/verify でオフプラットフォームから検証するか、spend_status から取得した公開署名鍵を使って verify_receipt で検証できます。

ローカルでのリリース検証

Node.js 20.19 以降が必要です。このパッケージまたは公開ミラーから npm ci、npm test、npm run scan:release を実行してください。ロックファイルでは公開済みの spend 0.19.0 パッケージを使用しているため、非公開の同階層チェックアウトは不要です。

リリースチェックリスト：package.json、src/index.ts のサーバーバージョン、server.json 内の両方のバージョンを一致させます。テストとリリーススキャンを実行し、まず npm に公開してから mcp-publisher で公開し、レジストリの有効なエントリーを確認します。正確なコマンドと公開ミラーの許可リストについては、レジストリのリリースガイドをご覧ください。

公式レジストリ名は io.github.MerchantGuard/agentguard です。そのパッケージエントリーは、npx と stdio を介して @agentguard-run/mcp をローカルで実行します。

AgentGuard® は Dunecrest Ventures Inc. の登録商標です。米国特許を出願中です。このパッケージはガバナンスソフトウェアであり、法律上またはコンプライアンス上の助言ではありません。