English Français العربية

io.github.kakunin-ai/kakunin

السجل الرسمي الأمن

X.509 identity, risk scoring, and audit logging for AI agents. MiCA + EU AI Act compliant.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @kakunin/mcp
Claude Code 
claude mcp add kakunin -e 'KAKUNIN_API_KEY=<your kakunin_api_key>' -e 'KAKUNIN_AGENT_ID=<KAKUNIN_AGENT_ID>' -- npx -y @kakunin/mcp@0.2.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "kakunin": {
            "command": "npx",
            "args": [
                "-y",
                "@kakunin/mcp@0.2.4"
            ],
            "env": {
                "KAKUNIN_API_KEY": "<your kakunin_api_key>",
                "KAKUNIN_AGENT_ID": "<KAKUNIN_AGENT_ID>"
            }
        }
    }
}

متغيرات البيئة

  • KAKUNIN_API_KEY سري Kakunin API key (kak_live_... or kak_test_...). Obtain at https://kakunin.ai/dashboard.
  • KAKUNIN_AGENT_ID ID of the agent this MCP server acts on behalf of (agt_...).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @kakunin/mcp — MCP server for AI agent identity & compliance
  2. Tools
  3. Setup
  4. Sandbox mode
  5. Contributors

@kakunin/mcp — MCP server for AI agent identity & compliance

Model Context Protocol server for the Kakunin AI agent compliance API. Lets AI agents self-verify scope, check their own risk score, and log behavioral events — all from within Claude, Cursor, or any MCP-compatible runtime.

npx @kakunin/mcp

Tools

verify_agent_scope

Check whether this agent is authorised to perform an action before executing it. Verifies the active X.509 certificate, permitted_actions scope, financial limits, and revocation status.

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

Returns { allowed: true|false, reason, certificate_status, permitted_actions }.

check_risk_score

Retrieve the agent's rolling 30-day risk score, band (low/medium/high), drift trend, and actionable guidance. No input required.

audit_log_append

Append a behavioral event to the agent's immutable audit log. Returns risk score + transaction ID. Events scoring ≥ 0.85 auto-trigger a certificate revocation check.

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

Setup

Prerequisites: Node ≥ 18, Kakunin API key + Agent ID from kakunin.ai/dashboard.

Claude Desktop

Add to ~/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_..."
      }
    }
  }
}
Environment variables
VariableRequiredDescription
KAKUNIN_API_KEY✅API key (kak_live_... or kak_test_...)
KAKUNIN_AGENT_ID✅Agent ID the server acts on behalf of
KAKUNIN_BASE_URLoptionalOverride API base (default: https://kakunin.ai)

Sandbox mode

Use a kak_test_... key for development — hits the sandbox CA, no cost, 100 free certs/day.

Full docs at docs.kakunin.ai.

Contributors

Thanks to everyone who contributes (emoji key) — code and non-code alike:

Contributions of any kind are welcome — this project follows the all-contributors spec.

الأسئلة الشائعة

ما هو io.github.kakunin-ai/kakunin؟

X.509 identity, risk scoring, and audit logging for AI agents. MiCA + EU AI Act compliant.

كيف أثبّت io.github.kakunin-ai/kakunin؟

يعمل على جهازك. في Claude Code: claude mcp add kakunin -e 'KAKUNIN_API_KEY=<your kakunin_api_key>' -e 'KAKUNIN_AGENT_ID=<KAKUNIN_AGENT_ID>' -- npx -y @kakunin/mcp@0.2.4. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.kakunin-ai/kakunin إلى مفتاح API؟

نعم. يتطلب KAKUNIN_API_KEY، وتضبطها في إعداداته.

هل io.github.kakunin-ai/kakunin مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون io.github.kakunin-ai/kakunin؟

ينشره kakunin-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.