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: 获取特定电话号码的详细信息。
扫码联系在线客服