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": ""
}
}
}
}

使用 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": [
"/dist/index.js"
],
"env": {
"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: 获取特定电话号码的详细信息。