返回 MCP 目录
public公开dns本地运行

Voicebot-MCP-Server

这是一个MCP服务器项目,提供通过WhatsApp发送接收语音消息并与AI客户端Claude Desktop交互的功能。

article

README

🚀 Voicebot-MCP-Server

这是一个 MCP 服务器,它具备发送和接收语音消息的功能,可通过即时通讯应用 WhatsApp 与 AI 客户端 Claude Desktop 实现交互,为语音消息的处理和交互提供了便捷的解决方案。

🚀 快速开始

该服务器的主要功能是提供语音消息的收发,并借助 WhatsApp 和 Claude Desktop 实现交互。以下是启动服务器的具体步骤:

📦 安装指南

安装所需库

pip install flask twilio uv dotenv

安装 MCP SDK

pip install "mcp[cli]"

集成与测试

将服务器与 Claude Desktop 集成

mcp install server.py --name "VoiceBot MCP 服务器"

使用 MCP Inspector 测试服务器

mcp dev server.py

使用 ngrok 运行 Webhook

ngrok http 5003

💻 使用示例

基础用法

whatsapp_webhook.py 中,可以提供个人 WhatsApp 号码到 "WHATSAPP_VERIFY_NUMBER" 来与基于 Claude 的 MCP 服务器交互。所有必要的 API 令牌和 ID 都保留在 .env 文件中。

🔧 技术细节

本项目依赖多个关键库来实现其功能,以下是这些库及其作用的详细说明: | 库名 | 作用 | | ---- | ---- | | MCP SDK | 提供与 MCP 相关的核心功能 | | dotenv | 用于存储和管理 .env 文件中的环境变量 | | requests | 用于发送 HTTP 请求 | | json | 用于处理 JSON 数据 | | uv | 用于与 MCP Inspector 进行测试 | | Flask | 用于构建 Web 服务器 | | Twilio | 用于处理与 WhatsApp 的交互 |

⚠️ 重要提示

whatsapp_webhook.py 中,可以提供个人 WhatsApp 号码到 "WHATSAPP_VERIFY_NUMBER" 来与基于 Claude 的 MCP 服务器交互。所有必要的 API 令牌和 ID 都保留在 .env 文件中。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端