项目简介

Vapi MCP 服务器是基于 Model Context Protocol (MCP) 标准实现的服务器,它通过集成 Vapi API,使得 LLM 客户端能够利用 Vapi 提供的各种功能,例如创建和管理 AI 助手、发起电话呼叫、管理电话号码等。该服务器旨在为 LLM 应用提供一个安全、可扩展的上下文服务框架,使得 LLM 可以通过标准化的方式访问外部数据和功能。

主要功能点

  • 助手管理: 提供创建、列出和获取 Vapi 助手的工具,允许 LLM 调用 Vapi 的助手 API 来管理 AI 助手。
  • 电话呼叫: 支持创建、列出和获取 Vapi 电话呼叫的工具,使 LLM 能够发起和管理电话呼叫功能。
  • 电话号码管理: 提供列出和获取 Vapi 电话号码的工具,方便 LLM 客户端查询和使用电话号码资源。
  • 基于 MCP 协议: 完全遵循 Model Context Protocol 标准,易于与各种 MCP 客户端集成。
  • 使用 Vapi API: 后端服务基于 Vapi API,需要配置 Vapi API 令牌才能正常使用 Vapi 的各项功能。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的开发环境中已安装 Node.js 和 npm (Node 包管理器)。

  2. 安装 Vapi MCP 服务器: 使用 npm 或 npx 命令安装 '@vapi-ai/mcp-server' 包。

    npm install -g @vapi-ai/mcp-server

    或者使用 npx 直接运行:

    npx -y @vapi-ai/mcp-server
  3. 设置 VAPI_TOKEN 环境变量: Vapi MCP 服务器需要 VAPI_TOKEN 环境变量来访问 Vapi API。请在运行服务器之前设置该环境变量,替换 '<your_vapi_token>' 为你的实际 Vapi API 令牌。

    export VAPI_TOKEN=<your_vapi_token>

服务器配置

对于 MCP 客户端(例如 Claude Desktop),你需要配置 MCP 服务器的启动命令和参数。以下是 Claude Desktop 配置文件 'claude_desktop_config.json' 的配置示例:

{
  "mcpServers": {
    "vapi-mcp-server": {
      "command": "npx",
      "args": [
          "-y",
          "@vapi-ai/mcp-server"
      ],
      "env": {
        "VAPI_TOKEN": "<your_vapi_token>"  //  请替换为你的 Vapi API 令牌
      }
    }
  }
}
  • 'server name': 'vapi-mcp-server' (服务器名称,客户端配置中引用)
  • 'command': '"npx"' (启动服务器的命令)
  • 'args': '["-y", "@vapi-ai/mcp-server"]' (传递给 'npx' 命令的参数,'-y' 表示自动确认安装包)
  • 'env': '{"VAPI_TOKEN": "<your_vapi_token>"}' (环境变量配置,重要: 请将 '<your_vapi_token>' 替换为你的实际 Vapi API 令牌)

基本使用方法

  1. 启动 Vapi MCP 服务器: 根据安装步骤,使用 'npx -y @vapi-ai/mcp-server' 命令启动服务器(确保已设置 'VAPI_TOKEN' 环境变量)。
  2. 配置 MCP 客户端: 在你的 MCP 客户端(如 Claude Desktop)中,按照服务器配置部分提供的示例配置连接到 Vapi MCP 服务器。
  3. 在 LLM 中使用工具: 当客户端连接到 Vapi MCP 服务器后,LLM 就可以通过工具调用 Vapi 提供的功能了。例如,可以指示 LLM 调用 'list_assistants' 工具来获取 Vapi 助手列表,或调用 'create_call' 工具来发起电话呼叫。具体的工具名称和使用方法请参考该仓库提供的文档或代码。

信息

分类

网页与API