Vapiai MCP Server

🚀 Vapi MCP 服務器

Vapi 模型上下文協議 服務器支持您通過函數調用與 Vapi API 集成，為您提供便捷的 API 交互體驗。

🚀 快速開始

Claude 桌面設置

1. 打開 Claude Desktop，按下 Command + , 進入 設置。
2. 點擊 開發者 標籤。
3. 點擊 編輯配置 按鈕，此時會在文件資源管理器中打開 claude_desktop_config.json 文件。
4. 從 Vapi 控制檯 (https://dashboard.vapi.ai/org/api-keys) 獲取您的 Vapi API 密鑰。
5. 將以下內容添加到 claude_desktop_config.json 文件中，更多詳細信息可參見 此處。
6. 編輯配置文件後重新啟動 Claude Desktop。

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

使用 Claude 桌面的示例

1. 在 Vapi 控制檯中創建或導入一個電話號碼 (https://dashboard.vapi.ai/phone-numbers)。
2. 使用 Vapi 控制檯中的現有“預約安排器”模板創建一個新的助手 (https://dashboard.vapi.ai/assistants)。
3. 確保配置了 Claude Desktop 以使用 Vapi MCP 服務器，並重新啟動 Claude Desktop 應用程序。
4. 使用以下消息詢問 Claude：

我想安排一個預約，你能通過我的電話號碼 +1234567890 連接 Riley 助手嗎？

遠程 SSE 連接

要通過 Server-Sent Events (SSE) 傳輸連接到 Vapi 的 MCP 服務器，您可以按以下步驟操作：

• 從任何 MCP 客戶端使用 SSE 傳輸連接到 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>"
      }
    },
  }
}

高級用法

測試

項目提供了兩種類型的測試：

單元測試

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

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

端到端測試

E2E 測試會運行完整的 MCP 服務器，並進行實際調用到 Vapi 的 API。

# 設置您的 Vapi API 令牌
export VAPI_TOKEN=your_token_here

# 運行 E2E 測試
npm run test:e2e

注意：E2E 測試需要在環境中設置有效的 Vapi API 令牌。

執行所有測試

要一次運行所有測試，可使用以下命令：

npm test

📚 詳細文檔

參考資料

• VAPI 遠程 MCP 服務器
• VAPI MCP 工具
• 模型上下文協議