Vapi MCP Server

Vapi MCP 服务

使用 Vapi 和 Model Context Protocol 构建 AI 语音助手和电话 Agent。

设置

MCP 服务需要 Vapi API 密钥。请从 Vapi 控制面板获取。

本地服务（stdio）

配置任何支持本地 stdio 服务的 MCP 客户端来运行：

npx -y @vapi-ai/mcp-server

在服务环境中设置 VAPI_TOKEN。MCP 客户端的配置格式各不相同，但服务定义通常如下所示：

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

远程服务（Streamable HTTP）

支持远程 MCP 服务的客户端可以直接连接：

• URL：https://mcp.vapi.ai/mcp
• 标头：Authorization: Bearer your_vapi_api_key_here

特定客户端示例

Claude Code

claude mcp add -e VAPI_TOKEN=your_vapi_token vapi -- npx -y @vapi-ai/mcp-server

Claude Desktop

在 Claude Desktop 配置文件中使用上述本地服务配置。如需通过 stdio 桥接连接托管服务，请使用：

{
  "mcpServers": {
    "vapi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.vapi.ai/mcp",
        "--header",
        "Authorization: Bearer ${VAPI_TOKEN}"
      ],
      "env": {
        "VAPI_TOKEN": "<your_vapi_token>"
      }
    }
  }
}

可选 Agent 技能

skill 目录包含可供支持 Agent Skills 的 AI 编码 Agent 使用的可复用说明。请使用宿主提供的技能安装流程进行安装。

对于 Claude Code：

mkdir -p ~/.claude/skills/vapi
curl -o ~/.claude/skills/vapi/SKILL.md https://raw.githubusercontent.com/VapiAI/mcp-server/main/skill/SKILL.md

---

使用示例

创建语音助手

向已启用 MCP 的 Agent 提出请求：

I want to build a voice assistant that can schedule appointments

拨打外呼电话

Call +1234567890 using my appointment reminder assistant with these details:
- Customer name: Sarah Johnson
- Appointment date: March 25th
- Appointment time: 2:30 PM

安排未来的通话

Schedule a call with my support assistant for next Tuesday at 3:00 PM to +1555123456

---

在助手提示词中使用变量值

create_call 操作支持通过 assistantOverrides.variableValues 传递动态变量。在助手的提示词中使用双花括号：{{variableName}}。

包含变量的提示词示例

Hello {{customerName}}, this is a reminder about your appointment on {{appointmentDate}} at {{appointmentTime}} with {{doctorName}}.

默认变量

以下变量会自动提供（无需传递）：

• {{now}} - 当前日期和时间（UTC）
• {{date}} - 当前日期（UTC）
• {{time}} - 当前时间（UTC）
• {{month}} - 当前月份（UTC）
• {{day}} - 当前月中的日期（UTC）
• {{year}} - 当前年份（UTC）
• {{customer.number}} - 客户的电话号码

如需了解高级日期／时间格式设置，请参阅 Vapi 文档。

---

远程 MCP 服务

从任何 MCP 客户端连接到 Vapi 托管的 MCP 服务：

Streamable HTTP（推荐）

• URL：https://mcp.vapi.ai/mcp
• 标头：Authorization: Bearer your_vapi_api_key_here

SSE（已弃用）

• URL：https://mcp.vapi.ai/sse
• 标头：Authorization: Bearer your_vapi_api_key_here

---

可用工具

助手

工具	描述
list_assistants	列出所有助手
get_assistant	按 ID 获取助手
create_assistant	创建新助手
update_assistant	更新助手

通话

工具	描述
list_calls	列出通话记录
get_call	获取通话详情
create_call	发起外呼（立即拨打或安排拨打）

电话号码

工具	描述
list_phone_numbers	列出电话号码
get_phone_number	获取电话号码详情

工具（函数调用）

工具	描述
list_tools	列出自定义工具
get_tool	获取工具详情
create_tool	创建用于 API 集成的工具
update_tool	更新工具

---

开发

# Install dependencies
npm install

# Build
npm run build

# Test with MCP inspector
npm run inspector

本地开发配置

{
  "mcpServers": {
    "vapi-local": {
      "command": "node",
      "args": ["<path>/dist/index.js"],
      "env": {
        "VAPI_TOKEN": "<your_vapi_token>"
      }
    }
  }
}

测试

# Safe default suite (build, mocked execution, contract, and stdio compatibility)
npm test

# Unit tests (mocked public tool execution and catalog contract)
npm run test:unit

# Documentation/tool-catalog consistency lint
npm run test:docs

# Full TypeScript check (production and test code)
npm run typecheck

# Build and run local stdio protocol compatibility tests (no Vapi API calls)
npm run test:stdio

# Pack, install, and launch the package from a clean temporary consumer
npm run test:package

# Live read-only API tests
export VAPI_TOKEN=your_token_here
npm run test:live:readonly

# Live mutating tests (creates and cleans up disposable assistants and tools)
export VAPI_TOKEN=your_test_org_token_here
npm run test:live:mutating

---

参考资料

• Vapi 文档
• Vapi 控制面板
• Vapi 远程 MCP 服务
• Model Context Protocol