语音AI管理服务器

Vapi MCP Server是一个专为Vapi Voice AI平台设计的自定义模型上下文协议服务器,用于连接AI模型和Vapi基础设施,实现语音机器人和电话呼叫的管理。

  • by ageborn-dev
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 ageborn-dev/vapi-mcp-server

使用说明

Vapi MCP服务器

嘿!这是一个专门为Vapi语音AI平台设计的自定义模型上下文协议(MCP)服务器。我构建这个是为了弥合人工智能模型和Vapi基础设施之间的差距,允许代理实际管理语音机器人和电话,而不仅仅是谈论它们。

该项目由以下人员建造和维护 老年人.

这是干什么用的?

基本上,如果你使用的是Claude Desktop或任何其他兼容MCP的客户端,你可以插入此服务器,并授予你的AI对Vapi仪表板的“管理员权限”。它可以创建助手、触发出站呼叫、购买电话号码,并直接通过聊天界面查看您的分析。

快速设置

运行此程序非常简单,但您需要正确的密钥。

🔑 了解Vapi API密钥

Vapi在您的仪表板中提供了两种类型的按键。使用正确的方法很重要:

  1. API私有密钥(承载令牌):

    • 这是干什么用的:完全服务器端访问。这就是此MCP服务器管理您的助手、发起呼叫和拉取分析所需的内容。
    • 在哪里可以找到它首选 仪表板.vapi.ai,单击 组织设置,并寻找 API密钥 选项卡。您将在那里看到您的“私钥”或“承载令牌”。
    • 安全:切勿共享此密钥。它授予您对帐户的完全控制权。
  2. 公钥:

    • 这是干什么用的:严格用于客户端集成(如在网站或移动应用程序中嵌入语音小部件)。
    • 用法:你 不要 MCP服务器需要这个。

🚀 安装和操作系统设置

  1. 克隆并安装:

    npm install
    
  2. 配置您的密钥:

    根据您的系统,以下是确保服务器看到您的API密钥的方法:

    • Windows(PowerShell):

      $env:VAPI_API_KEY = "your_private_key_here"
      # To make it permanent, add it to your System Environment Variables via Settings.
      
    • Mac/Linux(终端):

      export VAPI_API_KEY="your_private_key_here"
      # Add this to your ~/.zshrc or ~/.bashrc to keep it after restart.
      

    或者,只需创建一个 .env 根目录中的文件:

    cp .env.example .env
    
  3. 构建与启动:

    npm run build
    npm start
    

工具集

该服务器配备了30多种高级工具,可直接映射到最新的Vapi 2026平台架构。以下是您的AI实际可以做的事情的细分:

  • 助手:为您的语音机器人提供完整的CRUD(创建、读取、更新、删除)支持(支持最新的Vapi Voices集合)。
  • 呼叫:开始调用、结束调用,并在本地运行详细的AI评估。
  • 电话号码:从Twilio/Vonage和其他提供商处购买新号码或无缝导入现有号码。
  • 知识与工具:部署和管理为您的助手提供动力的自定义服务器功能、Webhook和工具节点。
  • 小队:处理多助手切换并构建复杂的会话架构。
  • 聊天和会话:Vapi聊天会话的完整CRUD,允许您在不发起电话的情况下与助手进行本地测试和聊天。
  • 工作流:直接从IDE或聊天客户端使用AI生成整个Vapi工作流。
  • 诊断和数据:提取活动分析、成本报告和深度诊断 人工制品 从已完成的通话中——反映了Vapi更新的2026年可观测性系统。
  • 支持:直接向Vapi团队提交支持票。

如何与您的AI代理集成

由于此服务器是基于标准模型上下文协议(MCP)构建的,因此您可以将其附加到 任何 MCP兼容的AI客户端(如Claude Desktop、Cursor或您首选的IDE/Agent环境)。

1.配置服务器

大多数MCP客户端依赖于标准 mcp_config.json 文件(有时是UI菜单)来连接本地服务器。

将以下条目添加到配置文件中(确保将占位符路径替换为计算机上的实际绝对路径):

{
  "mcpServers": {
    "vapi": {
      "command": "node",
      "args": ["/absolute/path/to/vapi-mcp-server/build/index.js"],
      "env": {
        "VAPI_API_KEY": "your_private_api_key_here"
      }
    }
  }
}

2.保存并重新启动

保存配置并重新启动或刷新AI客户端。

🚀 用法

一旦注册并通过身份验证,您就可以自然地询问您的AI代理: “列出我的Vapi助手” 或 “启动Vapi聊天会话…” 代理将安全地利用此后端直接执行您的命令!


用爱建造❤️ 和☕ 通过 老年人