JinDaGe - Vapi MCP Server MCP Details

article

README

🚀 Vapi MCP 服务器

Vapi MCP 服务器基于模型上下文协议，允许您通过功能调用与 Vapi API 集成，为您提供便捷的 API 交互体验。

🚀 快速开始

使用 Claude Desktop 的设置

打开 Claude Desktop，然后按 CMD + , 以进入 设置。
点击 开发者 标签。
点击 编辑配置 按钮。
这将打开文件资源管理器中的 claude_desktop_config.json 文件。
在 Vapi 控制台 (https://dashboard.vapi.ai/org/api-keys) 处获取您的 Vapi API 密钥。
将以下内容添加到 claude_desktop_config.json 文件中。有关更多详细信息，请参见此处。
编辑配置文件后重新启动 Claude Desktop。

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

使用 Claude Desktop 的示例用法

在 Vapi 控制台 (https://dashboard.vapi.ai/phone-numbers) 处创建或导入一个电话号码。
在 Vapi 控制台 (https://dashboard.vapi.ai/assistants) 处使用现有 'Appointment Scheduler' 模板创建新的助理。
确保将 Claude Desktop 配置为使用 Vapi MCP 服务器并重新启动 Claude Desktop 应用程序。
让 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: 获取特定电话号码的详细信息。

Vapi MCP Server