agent-spend-policy-mcp

DingDawg Agent Spend Policy MCP

提案されたエージェントの支出アクションが、指定されたポリシーに適合するかを決定論的に評価する、小規模なローカル MCP サーバーです。

安定した理由コードとともに、ELIGIBLE、DENY、STEP_UP のいずれかを返します。 ELIGIBLE はローカルポリシーの証拠にすぎません。支払いの承認ではありません。

安全性の境界

このパッケージは、資金、秘密鍵、支払い認証情報、顧客データ、決済権限を保持しません。支払いの署名、送信、決済、保管、記録は行いません。ネットワークリクエストも行いません。

本番環境の支払いアダプターには、認証済みのポリシー／アクションの来歴、正規化されたペイロードのハッシュ化、永続的かつアトミックな予算の予約とリプレイ保護、顧客管理の署名、決済レールの検証、決済照合のための、独立して検証された制御が別途必要です。

インストール

npx -y @dingdawg/agent-spend-policy-mcp

ローカル stdio MCP サーバーとして設定します。

{
  "mcpServers": {
    "dingdawg-agent-spend-policy": {
      "command": "npx",
      "args": ["-y", "@dingdawg/agent-spend-policy-mcp"]
    }
  }
}

ツール

evaluate_spend_policy は、評価時刻、ポリシー、提案されたアクション、すでに支出した金額を受け取ります。すべての金額はマイクロ単位の整数文字列で渡され、JavaScript の浮動小数点数は使用しません。

呼び出し元が時刻とすでに支出した金額を指定するため、このツールはドライランやローカルの証拠としては安全ですが、信頼できる支払いシステムや会計システムの代替にはなりません。

エージェントの契約

バージョン管理された機械可読な契約は、capabilities.json です。このパッケージが公開する唯一のツール、必須入力、3 つの可能な結果、そして譲れない安全性の境界を記述しています。

• トランスポート：ローカル stdio MCP
• ツール：evaluate_spend_policy
• 必須入力：evaluationTime、policy、action、および alreadySpentMicros
• 出力：ELIGIBLE、DENY、STEP_UP のいずれか。それぞれに安定した理由コードが付属します
• 副作用：なし
• 認証情報、支払いの実行、保管、署名、決済、ネットワークアクセス：非対応

マニフェストはこのリリースのパッケージソースの証拠であり、ホストされたエージェント検出エンドポイントを保証するものではありません。ELIGIBLE は引き続きローカルポリシーの証拠にすぎず、支払いの承認ではありません。

開発

npm install
npm test
npm run pack:check