agent-audit-mcp

AgentAudit MCP

エージェントが実行するすべてのアクションを、改ざんを検知できる不変のログに記録します。各イベントは暗号技術によって前のイベントと結び付けられているため、変更が加えられるとチェーンが途切れ、すぐに検知できます。

エージェントにできること

• 16 種類のイベント（決済、タスク、異議申し立て、本人確認、メッセージ）を、前のイベントのハッシュを含む SHA-256 ハッシュとともに記録します
• ID を指定して任意のエージェントの全履歴を取得します。すべてのアクションをタイムスタンプ付きで順番に確認できます
• エージェント、イベントの種類、重大度、日付範囲で監査ログを検索します
• 任意の 2 つのイベント間でチェーンの整合性を検証し、どのリンクが改ざんされたかを正確に示すイベントごとの合否内訳を取得します
• info、notice、warning、error、critical の 5 段階の重大度で、コンプライアンスのトリアージを管理します
• 監査ログ全体の統計情報を取得します。イベントの種類別・重大度別の内訳と、最もアクティブなエージェントを確認できます

インストール

必要条件： Python 3.10 以降、mcp パッケージ、fastmcp パッケージ。

pip install mcp fastmcp

Claude Desktop — macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "agent-audit": {
      "command": "python",
      "args": ["/absolute/path/to/agent-audit-mcp/server.py"]
    }
  }
}

Cursor — プロジェクトのルートにある .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "agent-audit": {
      "command": "python",
      "args": ["/absolute/path/to/agent-audit-mcp/server.py"]
    }
  }
}

データはローカルの ~/.agentaudit/chain.json に保存されます。データがマシンの外部に送信されることはありません。

ツールのリファレンス

ツール	説明	主なパラメーター
audit_log	イベントを記録し、ハッシュチェーンに追加します	event_type（16 種類のいずれか）、agent_id、severity、details_json
audit_get_event	ID を指定してイベントの詳細をすべて取得します	event_id
audit_search	エージェント、種類、重大度、日付範囲でイベントを絞り込みます	agent_id、event_type、severity、from_date、to_date、max_results
audit_get_agent_history	1 つのエージェントの全イベントを新しい順に取得します	agent_id、max_events
audit_verify_chain	2 つのイベント間の SHA-256 チェーンの整合性を確認し、イベントごとの合否を返します	from_event_id、to_event_id
audit_stats	概要：イベント総数、種類別・重大度別の内訳、アクティブなエージェント上位 5 件	—

対応するイベントの種類： task_created、task_assigned、task_completed、task_failed、payment_sent、payment_received、payment_refunded、dispute_raised、dispute_resolved、identity_verified、capability_used、agent_registered、agent_rated、agent_offline、message_sent、message_received

セキュリティ

監査データは、チェーンの破損につながる部分的な書き込みを防ぐため、アトミックに書き込まれます（一時ファイルへの書き込み後、os.replace で置き換えます）。ハッシュは前のイベントのハッシュを含むすべてのフィールドを対象とするため、後続のすべてのハッシュを壊さずにイベントを挿入、削除、変更することはできません。audit_verify_chain は保存済みの値を信頼せず、各ハッシュを最初から再計算します。

すべてのデータはローカルに保存されます。このサーバーからネットワークリクエストが送信されることはありません。

料金

プラン	料金	含まれる内容
Pro	$19/month	監査イベント数無制限、チェーンの完全な検証

Stripe で購読する

ライセンス

プロプライエタリ — 購読条件をご確認ください。ソースコード：github.com/Rumblingb/agent-audit-mcp