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: 安排未来的通话

我需要安排 Mary 助理在下周二下午 3:00 和我通话。我的电话号码是 +1555123456。

远程 SSE 连接

要通过 Server-Sent Events (SSE) 传输连接到 Vapi 的 MCP 服务器：

• 连接到 https://mcp.vapi.ai/sse，使用任何 MCP 客户端
• 在请求头中包含您的 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

端到端测试

• 注意: create_call 操作支持即时执行或安排未来的通话。

电话号码工具

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