kolivri-voice-mcp

kolivri-voice-mcp — Claude Code、OpenCode、Cursor、Claude Desktop 向けの実際の AI 電話回線

kolivri-voice-mcp は、Kolivri（app.kolivri.co.il）を利用した実際の電話回線を AI コーディングエージェントとオペレーターエージェントに提供する、依存関係ゼロの Node.js ESM Model Context Protocol（MCP）サーバーです。

機能とツール

1. kolivri_place_call — POST ${KOLIVRI_API_URL}/api/v1/engine/trigger/${webhookId} を介して、発信 AI 音声通話を開始します。
   • イスラエル形式（054-1234567）と国際 E.164 形式（+972541234567）の電話番号を正規化します。
   • 言語を許可リスト（he、en、ar、ru、fr、es、de、pt、デフォルトは he）に制限します。
   • KYC 認証済み発信者チェック（verifiedCallerId と、任意の KOLIVRI_VERIFIED_CALLER_ID 許可リスト）を適用します。
   • ロボコールのループを防ぐため、API キーごとにスライディングウィンドウ方式のレート制限（KOLIVRI_MAX_CALLS_PER_MINUTE、デフォルトは 5/min）を適用します。
2. kolivri_get_call_status — 通話ステータス、構造化された結果、文字起こし、要約、予約ステータス、録音 URL を取得します。
3. kolivri_carrier_forwarding_codes — イスラエルの通信事業者（partner、pelephone、cellcom、hot_mobile、golan、019、we4g、bezeq）向けに、正確な 30 秒の GSM／IMS 着信転送ダイヤル文字列（*61*、*67*、*62*、*004*、*21*、およびリセット用の ##002#）を生成します。
4. kolivri_preview_roi — SMB の月間の不在着信による損失と回収可能な収益を算出し、該当する Kolivri 統合プラン（Starter $69 / ₪247、Business $139 / ₪479、Pro $249 / ₪880）を提案します。

環境変数

変数	必須	デフォルト	説明
KOLIVRI_API_KEY	はい（実際の通話の場合）	—	x-api-key ヘッダーで送信する Kolivri API キー
KOLIVRI_WEBHOOK_ID	任意	default-webhook	デフォルトの Kolivri キャンペーン／エンジンの webhook ID
KOLIVRI_VERIFIED_CALLER_ID	任意	—	KYC 認証済み発信者 ID。E.164 形式またはイスラエル形式で、カンマ区切りで指定します
KOLIVRI_API_URL	任意	https://app.kolivri.co.il	Kolivri API のベース URL
KOLIVRI_MAX_CALLS_PER_MINUTE	任意	5	API キーごとの 1 分あたりの最大発信数

インストール

1. Claude Code（claude mcp add）

claude mcp add kolivri-voice \
  -e KOLIVRI_API_KEY="your-kolivri-api-key" \
  -e KOLIVRI_WEBHOOK_ID="your-webhook-id" \
  -e KOLIVRI_VERIFIED_CALLER_ID="+97235550199" \
  -- node /path/to/kolivri-code/kolivri-voice-mcp/src/server.mjs

2. OpenCode（~/.config/opencode/opencode.json）

opencode.json の "mcp" キーに kolivri-voice を追加します。

{
  "mcp": {
    "kolivri-voice": {
      "type": "local",
      "command": ["node", "/path/to/kolivri-code/kolivri-voice-mcp/src/server.mjs"],
      "environment": {
        "KOLIVRI_API_KEY": "your-kolivri-api-key",
        "KOLIVRI_WEBHOOK_ID": "your-webhook-id",
        "KOLIVRI_VERIFIED_CALLER_ID": "+97235550199"
      },
      "enabled": true
    }
  }
}

3. Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "kolivri-voice": {
      "command": "node",
      "args": ["/path/to/kolivri-code/kolivri-voice-mcp/src/server.mjs"],
      "env": {
        "KOLIVRI_API_KEY": "your-kolivri-api-key",
        "KOLIVRI_WEBHOOK_ID": "your-webhook-id",
        "KOLIVRI_VERIFIED_CALLER_ID": "+97235550199"
      }
    }
  }
}

テストの実行

node --test kolivri-voice-mcp/test/voice-mcp.test.mjs