🚀 Vapi MCP Server
Vapi MCP Server 是一个基于 Model Context Protocol 的服务器，它允许你通过函数调用的方式集成 Vapi API，为你提供便捷的 API 调用体验。
🚀 快速开始
Claude Desktop 配置
如果你使用的是 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": ""
}
}
}
}
使用 Claude Desktop 的示例
- 使用 Vapi 仪表盘（https://dashboard.vapi.ai/phone-numbers）创建或导入一个电话号码。
- 使用 Vapi 仪表盘（https://dashboard.vapi.ai/assistants）中现有的“预约调度器”模板创建一个新的助手。
- 确保将 Claude Desktop 配置为使用 Vapi MCP 服务器，并重启 Claude Desktop 应用程序。
- 要求 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": [
"/dist/index.js"
],
"env": {
"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 服务器提供以下集成工具：
助手工具
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：获取特定电话号码的详细信息