MCP Server

🚀 Vapi MCP Server

Vapi MCP Server 是一个基于 Model Context Protocol 的服务器，它允许你通过函数调用的方式集成 Vapi API，为你提供便捷的 API 调用体验。

🚀 快速开始

Claude Desktop 配置

如果你使用的是 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）中现有的“预约调度器”模板创建一个新的助手。
3. 确保将 Claude Desktop 配置为使用 Vapi MCP 服务器，并重启 Claude Desktop 应用程序。
4. 要求 Claude 发起或安排一个电话。以下是一些示例：

示例 1：请求立即通话

I'd like to speak with my ShopHelper assistant to talk about my recent order. Can you have it call me at +1234567890?

示例 2：安排未来通话

I need to schedule a call with Mary assistant for next Tuesday at 3:00 PM. My phone number is +1555123456.

💻 远程 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

端到端测试

端到端测试会运行完整的 MCP 服务器，并实际调用 Vapi API。

# 设置你的 Vapi API 令牌
export VAPI_TOKEN=your_token_here

# 运行端到端测试
npm run test:e2e

注意：端到端测试需要在环境中设置有效的 Vapi API 令牌。

运行所有测试

要一次性运行所有测试：

npm test

📚 详细文档

参考资料

• VAPI 远程 MCP 服务器
• VAPI MCP 工具
• Model Context Protocol
• Claude Desktop

支持的操作

Vapi MCP 服务器提供以下集成工具：

助手工具

• list_assistants：列出所有 Vapi 助手
• create_assistant：创建一个新的 Vapi 助手
• get_assistant：按 ID 获取一个 Vapi 助手

通话工具

• list_calls：列出所有 Vapi 通话
• create_call：创建一个外拨电话
• get_call：获取特定通话的详细信息

⚠️ 重要提示：create_call 操作支持立即执行或安排未来时间的通话。

电话号码工具

• list_phone_numbers：列出所有 Vapi 电话号码
• get_phone_number：获取特定电话号码的详细信息