MCP-VoiceAI-WhiteLabel

🚀 如何更新AWS MCP服务器

核心功能描述

本项目是VoiceAI VAVicky AiAgency平台完整的MCP服务器实现，具备用户管理、API令牌管理、助手管理等多种功能，能帮助用户高效管理语音AI相关业务。

🚀 快速开始

更新MCP服务器

此命令将更新AWS上的代码，重启MCP服务器并打开日志。

cd MCP-VoiceAI-WhiteLabel/ && git pull && pm2 restart 6 && pm2 logs 6

退出日志

Press CTRL+C

✨ 主要特性

用户管理

• 获取包括令牌和设置在内的用户数据
• 更新白标详情（名称、描述、域名、颜色）
• 更新SMTP设置以实现自定义电子邮件通知

API令牌管理

• 更新OpenAI API密钥
• 更新ElevenLabs API密钥
• 更新Deepseek API密钥
• 更新Google Gemini API密钥
• 更新Open Router API密钥

助手管理

• 获取所有助手
• 获取特定助手信息
• 创建具有全面配置的新助手
• 更新现有助手
• 删除助手
• 管理助手文件
• 获取使用统计和分析数据
• 与助手聊天

Twilio集成

• 连接/断开Twilio账户
• 获取可用电话号码
• 购买电话号码
• 管理现有号码
• 获取使用统计数据

通信功能

• 进行单个电话呼叫
• 进行批量电话呼叫
• 发送SMS消息
• 取消正在进行的呼叫
• 监控正在进行的呼叫

📦 安装指南

1. 克隆或创建项目：

   mkdir vavicky-mcp-server
   cd vavicky-mcp-server
   

2. 创建package.json：

   npm init -y
   npm install @modelcontextprotocol/sdk node-fetch
   

3. 使用提供的代码创建server.js文件

4. 设置环境变量：

   echo 'VAVICKY_API_KEY=your-api-key-here' > .env
   

5. 使服务器可执行：

   chmod +x server.js
   

💻 使用示例

基础用法

配置完成后，您可以在Claude中使用以下工具：

助手管理

Claude, create a new voice assistant named 'Sales Bot' with OpenAI GPT-4 that can make phone calls and has a professional greeting.

通信功能

Claude, send an SMS to +1234567890 using assistant ID 'assist_123' with the message 'Hello, this is a test message.'

分析功能

Claude, show me the usage statistics for all my assistants this month.

电话管理

Claude, get me a list of available toll-free numbers in the US and purchase one for my business.

📚 详细文档

工具参考

用户管理工具

• get_user - 获取包括令牌和设置在内的用户数据
• update_white_label - 更新白标品牌信息
• update_smtp - 配置电子邮件设置

令牌管理工具

• update_openai_token - 设置OpenAI API密钥
• update_elevenlabs_token - 设置ElevenLabs API密钥
• update_deepseek_token - 设置Deepseek API密钥
• update_gemini_token - 设置Gemini API密钥
• update_openrouter_token - 设置Open Router API密钥

助手工具

• get_assistants - 列出所有助手
• get_assistant - 获取助手基本信息
• get_one_assistant - 获取助手完整信息
• create_assistant - 创建新助手
• update_assistant - 更新助手设置
• delete_assistant - 删除助手
• get_assistant_files - 列出助手文件
• delete_assistant_file - 删除助手文件
• get_assistant_usage - 获取使用统计数据
• get_assistants_token_usage - 获取所有助手的令牌使用情况
• get_dashboard_assistant - 获取仪表盘助手
• chat_with_assistant - 与助手聊天

Twilio工具

• connect_twilio - 连接Twilio账户
• disconnect_twilio - 断开Twilio连接
• get_twilio_numbers - 列出电话号码
• get_available_numbers - 查找可用电话号码
• buy_twilio_number - 购买电话号码
• update_twilio_number - 配置电话号码设置
• get_twilio_usage - 获取Twilio使用统计数据

通信工具

• make_call - 进行电话呼叫
• make_bulk_call - 进行批量电话呼叫
• get_calls_in_progress - 列出正在进行的呼叫
• cancel_call - 取消正在进行的呼叫
• send_sms - 发送SMS消息

Claude桌面配置

将以下内容添加到Claude桌面配置文件中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "vavicky": {
      "command": "node",
      "args": ["/absolute/path/to/your/vavicky-mcp-server/server.js"],
      "env": {
        "VAVICKY_API_KEY": "your-vavicky-api-key-here"
      }
    }
  }
}

🔧 技术细节

错误处理

服务器包含全面的错误处理机制，可处理以下错误：

• API身份验证错误
• 无效参数错误
• 网络连接问题
• API速率限制问题

开发模式

要在开发模式下运行并进行调试，请执行以下命令：

npm run dev

安全措施

• API密钥通过环境变量传递
• 所有请求都包含正确的身份验证标头
• 对所有参数进行输入验证

📄 许可证

此MCP服务器遵循与原始Vavicky n8n节点实现相同的许可协议。

支持

• 若Vavicky平台出现问题，请访问：https://github.com/Business-On-Steroids/n8n-nodes-voiceai
• 若与MCP相关的问题，请参考Anthropic MCP文档。