kakunin について
@kakunin/mcpは、Kakunin APIを利用するAIエージェントのID・コンプライアンス管理用MCPサーバーです。操作権限の検証、リスクスコアの確認、行動イベントの監査ログへの追記ができます。
主な機能
- 01操作範囲と権限の検証
- 02推移するリスクスコアの確認
- 03変更不能な監査ログへのイベント追記
- 04証明書と金額上限の確認
活用シーン
- 01実行前のエージェント操作権限の検証
- 02エージェントのリスク状況の確認
- 03エージェント行動イベントの記録
- 04許可操作と取引上限の確認
MCP 対応
エージェントの操作範囲検証、リスクスコア照会、監査ログ記録のためのKakunin APIツールをMCP対応ランタイムに提供します。Kakunin APIキーとAgent IDが必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @kakunin/mcpKAKUNIN_API_KEYシークレットKakunin API key (kak_live_... or kak_test_...). Obtain at https://kakunin.ai/dashboard.KAKUNIN_AGENT_IDID of the agent this MCP server acts on behalf of (agt_...).ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
3掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| venue | string | いいえ | アクセスする取引所またはシステム(任意。例:"euronext"、"xetra")。 |
| action | string | はい | エージェントが実行する操作または呼び出すエンドポイント。スコープ文字列(例:"write:invoices")、API パス(例:"/api/v1/execute_trade")、または通常の説明文(例:"initiate EUR/USD trade on euronext for 50000 USD")を指定できます。 |
| amount_usd | number | いいえ | 財務スコープの適用に使用する取引金額(USD、任意)。 |
詳細
@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 の仕様に準拠しています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。