Vapi MCP Server

🚀 Vapi MCP 服務器

Vapi MCP 服務器基於 模型上下文協議，允許您通過功能調用與 Vapi API 集成，為您提供便捷的 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 發起或安排一個通話。以下是一些示例：

基礎用法

我希望與我的 ShopHelper 助手通話，討論我最近的訂單。你能讓它立即給我撥打 +1234567890 嗎？

高級用法

我需要安排 Mary 助理在下週二下午 3:00 和我通話。我的電話號碼是 +1555123456。

📦 安裝指南

# 安裝依賴項
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>"
      }
    },
  }
}

🔧 技術細節

遠程 SSE 連接

要通過 Server-Sent Events (SSE) 傳輸連接到 Vapi 的 MCP 服務器：

• 連接到 https://mcp.vapi.ai/sse，使用任何 MCP 客戶端。
• 在請求頭中包含您的 Vapi API 密鑰作為承載令牌。
• 示例頭：Authorization: Bearer your_vapi_api_key_here

此連接允許您在不運行本地服務器的情況下訪問 Vapi 的功能。

測試

該項目有兩種類型的測試：

單元測試

單元測試使用模擬來測試 MCP 服務器，而無需實際調用 Vapi 的 API。

# 運行單元測試
npm run test:unit

端到端測試

• 注意: create_call 操作支持即時執行或安排未來的通話。

電話號碼工具

• list_phone_numbers: 列出所有 Vapi 電話號碼。
• get_phone_number: 獲取特定電話號碼的詳細信息。