Vapiai MCP Server

🚀 Vapi MCP 服务器

Vapi 模型上下文协议 服务器支持您通过函数调用与 Vapi API 集成，为您提供便捷的 API 交互体验。

🚀 快速开始

Claude 桌面设置

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

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

使用 Claude 桌面的示例

1. 在 Vapi 控制台中创建或导入一个电话号码 (https://dashboard.vapi.ai/phone-numbers)。
2. 使用 Vapi 控制台中的现有“预约安排器”模板创建一个新的助手 (https://dashboard.vapi.ai/assistants)。
3. 确保配置了 Claude Desktop 以使用 Vapi MCP 服务器，并重新启动 Claude Desktop 应用程序。
4. 使用以下消息询问 Claude：

我想安排一个预约，你能通过我的电话号码 +1234567890 连接 Riley 助手吗？

远程 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": [
        "<path_to_vapi_mcp_server>/dist/index.js"
      ],
      "env": {
        "VAPI_TOKEN": "<your_vapi_token>"
      }
    },
  }
}

高级用法

测试

项目提供了两种类型的测试：

单元测试

单元测试使用模拟来测试 MCP 服务器，无需实际调用 Vapi API。

# 运行单元测试
npm run test:unit

端到端测试

E2E 测试会运行完整的 MCP 服务器，并进行实际调用到 Vapi 的 API。

# 设置您的 Vapi API 令牌
export VAPI_TOKEN=your_token_here

# 运行 E2E 测试
npm run test:e2e

注意：E2E 测试需要在环境中设置有效的 Vapi API 令牌。

执行所有测试

要一次运行所有测试，可使用以下命令：

npm test

📚 详细文档

参考资料

• VAPI 远程 MCP 服务器
• VAPI MCP 工具
• 模型上下文协议