JinDaGe - VapiAI_mcp-server MCP Details

article

README

🚀 Vapi MCP 服务器

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

🚀 快速开始

Claude 桌面设置

打开 Claude Desktop，按下 Command + , 进入 设置。
点击 开发者 标签。
点击 编辑配置 按钮，此时会在文件资源管理器中打开 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 桌面的示例

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

VapiAI_mcp-server