使用说明
Vapi MCP服务器
嘿!这是一个专门为Vapi语音AI平台设计的自定义模型上下文协议(MCP)服务器。我构建这个是为了弥合人工智能模型和Vapi基础设施之间的差距,允许代理实际管理语音机器人和电话,而不仅仅是谈论它们。
该项目由以下人员建造和维护 老年人.
这是干什么用的?
基本上,如果你使用的是Claude Desktop或任何其他兼容MCP的客户端,你可以插入此服务器,并授予你的AI对Vapi仪表板的“管理员权限”。它可以创建助手、触发出站呼叫、购买电话号码,并直接通过聊天界面查看您的分析。
快速设置
运行此程序非常简单,但您需要正确的密钥。
🔑 了解Vapi API密钥
Vapi在您的仪表板中提供了两种类型的按键。使用正确的方法很重要:
-
API私有密钥(承载令牌):
- 这是干什么用的:完全服务器端访问。这就是此MCP服务器管理您的助手、发起呼叫和拉取分析所需的内容。
- 在哪里可以找到它首选 仪表板.vapi.ai,单击 组织设置,并寻找 API密钥 选项卡。您将在那里看到您的“私钥”或“承载令牌”。
- 安全:切勿共享此密钥。它授予您对帐户的完全控制权。
-
公钥:
- 这是干什么用的:严格用于客户端集成(如在网站或移动应用程序中嵌入语音小部件)。
- 用法:你 不要 MCP服务器需要这个。
🚀 安装和操作系统设置
-
克隆并安装:
npm install -
配置您的密钥:
根据您的系统,以下是确保服务器看到您的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 -
-
构建与启动:
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聊天会话…” 代理将安全地利用此后端直接执行您的命令!
用爱建造❤️ 和☕ 通过 老年人