📬 WhatsApp-MCP: 支持流式消息的服务器

一个基于事件流的WhatsApp消息服务器，使用了FastMCP和Twilio API构建。 可以通过编程方式或浏览器使用服务端发送事件（Server-Sent Events）发送消息——非常适合代理、自动化或仪表板。

---

🛠 功能特性

• ✅ 支持FastMCP 2.x（支持流式HTTP传输）
• ✅ 使用Twilio WhatsApp沙盒进行实时消息传递
• ✅ 动态电话号码及消息输入（通过HTML或CLI）
• ✅ 使用text/event-stream进行流式响应
• ✅ 支持与AI代理、CLI或浏览器UI配合使用
• ✅ 可选：部署到Render、Railway、Replit

---

🚀 使用指南

🔧 1. 设置

git clone https://github.com/your-username/whatsapp-mcp.git
cd whatsapp-mcp
python -m venv venv
venv\Scripts\activate  # 或者 source venv/bin/activate
pip install -r requirements.txt

创建一个.env文件：

TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=your_twilio_auth_token
TWILIO_WHATSAPP_FROM=whatsapp:+14155238886

---

🧠 2. 启动服务器

python server.py

你会看到：

🔗 服务器URL: http://localhost:8000/mcp
📦 传输方式: 流式-HTTP

---

🌐 3. 使用浏览器界面

在浏览器中打开index.html。

输入：

• 📱 手机号码（例如，+91xxxxxxxxxx）
• 💬 消息内容

点击发送WhatsApp消息——立即接收！

---

🧪 4. 使用curl测试

curl -X POST http://localhost:8000/mcp ^
  -H "Content-Type: application/json" ^
  -H "Accept: text/event-stream" ^
  -d "{\"tool\":\"send_whatsapp_message\", \"inputs\":{\"to\":\"+91xxxxxxxxxx\", \"body\":\"Hello from curl!\"}}"

✅ 将+91xxxxxxxxxx替换为你已验证的WhatsApp号码

---

📊 系统流程（Mermaid图）

graph TD
  A[🧑 用户] -->|输入消息和号码| B[🌐 HTML界面]
  B -->|POST /mcp| C[🌀 FastMCP服务器]
  C -->|调用| D[📲 Twilio API]
  D -->|发送| E[📱 WhatsApp消息]
  C -->|流式响应| B

---

🧩 技术栈

• 🧠 FastMCP v2.x
• 🧪 Twilio WhatsApp API
• ⚙️ Python 3.11+
• 🌍 HTML + JS（Fetch API）
• 🔁 服务端发送事件（SSE）

---

🛡️ 安全注意事项

• 不要提交.env中的秘密信息
• 沙盒只能向已验证用户发送消息
• 升级到Twilio Business以获得完整的发送能力

---

🤖 代理就绪示例（Python）

from fastmcp import Client
from server import mcp

async with Client(mcp) as client:
    await client.call_tool("send_whatsapp_message", {
        "to": "+91xxxxxxxxxx",
        "body": "从代理触发的消息 🚀"
    })

---

💖 作者

由K Rajtilak用心制作