Vapi MCP Server

🚀 Vapi MCP サーバー

Vapi モデルコンテキストプロトコル サーバーを使用すると、機能呼び出しを通じて Vapi API と統合することができます。

🚀 クイックスタート

Claude Desktop の設定

1. Claude Desktop を開き、CMD + , を押して 設定 を開きます。
2. 開発者 タブをクリックします。
3. 編集設定 ボタンをクリックします。
4. これにより、ファイルエクスプローラーで claude_desktop_config.json ファイルが開きます。
5. Vapi コンソール (https://dashboard.vapi.ai/org/api-keys) で Vapi API キーを取得します。
6. claude_desktop_config.json ファイルに以下の内容を追加します。詳細は こちら を参照してください。
7. 設定ファイルを編集した後、Claude Desktop を再起動します。

{
  "mcpServers": {
    "vapi-mcp-server": {
      "command": "npx",
      "args": [
          "-y",
          "@vapi-ai/mcp-server"
      ],
      "env": {
        "VAPI_TOKEN": "<your_vapi_token>"
      }
    }
  }
}

Claude Desktop の使用例

1. Vapi コンソール (https://dashboard.vapi.ai/phone-numbers) で電話番号を作成またはインポートします。
2. Vapi コンソール (https://dashboard.vapi.ai/assistants) で既存の 'Appointment Scheduler' テンプレートを使用して新しいアシスタントを作成します。
3. Claude Desktop が Vapi MCP サーバーを使用するように設定されていることを確認し、Claude Desktop アプリケーションを再起動します。
4. Claude に通話を開始または予約させます。以下はいくつかの例です。

基本的な使用法

例 1: 即時通話の要求

最近の注文について、ShopHelper アシスタントと通話したいです。すぐに +1234567890 に電話してもらえますか？

高度な使用法

例 2: 将来の通話の予約

来週の火曜日の午後 3:00 に Mary アシスタントと通話を予約する必要があります。私の電話番号は +1555123456 です。

🔧 技術詳細

リモート SSE 接続

Server-Sent Events (SSE) を介して Vapi の MCP サーバーに接続するには：

• 任意の MCP クライアントを使用して https://mcp.vapi.ai/sse に接続します。
• リクエストヘッダーに Vapi API キーをベアラートークンとして含めます。
• ヘッダーの例：Authorization: Bearer your_vapi_api_key_here

この接続により、ローカルサーバーを実行せずに Vapi の機能にアクセスできます。

開発

# 依存関係のインストール
npm install

# サーバーのビルド
npm run build

claude_desktop_config.json を更新して、ローカルサーバーを使用するようにします。

{
  "mcpServers": {
    "vapi-local": {
      "command": "node",
      "args": [
        "<path_to_vapi_mcp_server>/dist/index.js"
      ],
      "env": {
        "VAPI_TOKEN": "<your_vapi_token>"
      }
    },
  }
}

テスト

このプロジェクトには 2 種類のテストがあります。

単体テスト

単体テストでは、Vapi の API を実際に呼び出さずに MCP サーバーをテストするためにモックが使用されます。

# 単体テストの実行
npm run test:unit

エンドツーエンドテスト

• 注意: create_call 操作は、即時実行または将来の通話の予約をサポートしています。

電話番号ツール

• list_phone_numbers: すべての Vapi 電話番号をリストします。
• get_phone_number: 特定の電話番号の詳細を取得します。