kakunin

@kakunin/mcp — AI エージェントのアイデンティティとコンプライアンスに対応する MCP サーバー

Kakunin の AI エージェントコンプライアンス API に対応する Model Context Protocol サーバーです。AI エージェントが Claude、Cursor、または MCP 互換ランタイムから、権限の範囲を自己検証し、自身のリスクスコアを確認して、行動イベントを記録できます。

npx @kakunin/mcp

ツール

verify_agent_scope

アクションを実行する前に、このエージェントにそのアクションを実行する権限があるか確認します。有効な X.509 証明書、permitted_actions の範囲、金額上限、失効状態を検証します。

{
  "action": "initiate EUR/USD trade on euronext for 50000 USD",
  "venue": "euronext",
  "amount_usd": 50000
}

{ allowed: true|false, reason, certificate_status, permitted_actions } を返します。

check_risk_score

エージェントの過去30日間のローリングリスクスコア、リスク帯（low／medium／high）、変動傾向、実行可能なガイダンスを取得します。入力は不要です。

audit_log_append

エージェントの変更不可な監査ログに行動イベントを追加します。リスクスコアとトランザクション ID を返します。スコアが 0.85 以上のイベントは、証明書の失効確認を自動的にトリガーします。

{
  "action_type": "transaction_initiated",
  "details": { "amount_usd": 50000, "venue": "NYSE" }
}

セットアップ

前提条件： Node ≥ 18、kakunin.ai/dashboard で取得した Kakunin API キーと Agent ID。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "kakunin": {
      "command": "npx",
      "args": ["-y", "@kakunin/mcp"],
      "env": {
        "KAKUNIN_API_KEY": "kak_live_...",
        "KAKUNIN_AGENT_ID": "agt_..."
      }
    }
  }
}

環境変数

変数	必須	説明
KAKUNIN_API_KEY	✅	API キー（kak_live_... または kak_test_...）
KAKUNIN_AGENT_ID	✅	サーバーが代理で動作する Agent ID
KAKUNIN_BASE_URL	任意	API のベース URL を上書きします（デフォルト：https://kakunin.ai）

サンドボックスモード

開発には kak_test_... キーを使用してください。サンドボックス CA に接続し、費用はかからず、1日に100件の証明書を無料で利用できます。

詳細なドキュメントは docs.kakunin.ai をご覧ください。

コントリビューター

コード、コード以外を問わず、貢献してくださった皆さんに感謝します（絵文字キー）：

どのような貢献も歓迎します。このプロジェクトは all-contributors の仕様に準拠しています。