内容
服务器（自定义构建）
适用于 Quick Desktop** 的App MCP（模型上下文协议）服务器 — 使 AI 助手能够读取、搜索和发送 WhatsApp 消息）。包含由 Amazon Bedrock Claude 驱动的自动回复 webhook。
> ⚠️ **个人账户仅限** — 使用非官方的 whatsmeow 库（WhatsApp Web 多设备 API）。不适用于 WhatsApp Business。Meta 可能阻止非官方访问。
---
## 功能
| 功能 | 描述 |
|---------|-------------|
| 🔍 **搜索与读取** | 搜索联系人、列出/筛选消息、分页聊天 |
| 📤 **发送消息** | 文本、图片、、语音消息 |
| 🖼️ **媒体下载** |消息中下载媒体 |
| 🤖 **自动回复 Webhook传入的消息触发 Bedrock Claude（文本 + 视觉） |
| 📱 **网页二维码配对** | 在 `http://localhost:889二维码，以便轻松链接手机 |
| 🔊 **音频转换** |音频转换为 Opus OGG 以发送 WhatsApp 语音消息 |
快速入门
```bash
# 1. 克隆
https://github.com/longlap/whatsapp-mcp.git
cd whatsapp-m 2. 运行设置
bash setup.sh
# 3. 启动桥梁二维码
cd whatsapp-bridge && ./whatsapp-```
然后将 MCP 配置添加到 Amazon Quick Desktop（设置 → 功能 → MCP 服务器）。
请参见下面的完整说明。
---
## 架构
```
┌─────────────────┐ stdio ┌──────────────────────┐
│ Amazon Quick │◄──────────────►│ Python MCP 服务器 │
│ Desktop │ │ (whatsapp-mcp-server)│
└─────────────────┘ └──────────┬───────────┘
│ HTTP :8080
▼
┌────────────────────── │ Go 桥梁 │
│ (whatsapp) │
│ + SQLite 数据库 │
└──────────┬───────────┘
│ WhatsApp Web API
▼
──────┐
│ WhatsApp 服务器 └──────────────────────┘
## 先决条件
| 工具 | 是否必需 | 目的 |
|------|----------|---------|
| **Go 1.21+** | ✅ | 构建 WhatsApp 桥梁 |
| **Python 3.11+** | ✅ | 运行 MCP 服务器 |
| **uv** | Python 包管理器 |
| Quick Desktop** | ✅客户端 |
| **FFmpeg 可选 | 语音消息的音频转换 |
|** | 可选仅用于 webhook 自动回复（Bedrock） |
---
##### 1. 构建 Go 桥梁
```bash
cd whatsapp-bridge
go build -o whatsapp-bridge
```
### 2. 安装 Python 依赖项
```bash
cd ../whatsapp-server
uv sync
```
或使用 pip：
```bash
-m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```
### 3. 首次运行 — 链接您的手机
```bash
cd ../whatsapp-bridge
./-bridge
```
使用 WhatsApp → 设置 → 链接设备 →设备扫描二维码。
**替代方法**：运行二维码 Web 服务器体验：
```bash
qrcode
python3 qr
# 访问 http://localhost:8899
```
### 配置 Amazon Quick Desktop
设置 → MCP 服务器 → 添加```json
{
"Servers": {
"what "command": "/ATH/TO/whatsapp-mvenv/bin/python",
["/FULL/PATH-mcp-server/main }
}
}
```
5. 重启 Amazon Quick---
## MCP 工具
工具 | 描述 |
||
| `search_contacts姓名或电话号码搜索 |
| `list_messages带有过滤器（日期件人、聊天、关键词 |
| `list_ch 列出按活动排序 |
| `send_message`电话号码或群组文本 |
| `send | 发送图片/视频/| `send_audio_message 发送语音消息（自动转换为） |
| `download_media` | 从消息中下载媒体## 自动回复 Webhook（
使用 Amazon Bedrock Claude传入的消息（文本 +）。
1. 配置 `webhook_listener.py` — 设置_JIDS`、`BEDRO`、`SYSTEM_PROMPT`
启动：`./start_web`
3. 在端口 9777 上运行
---
## 文件结构
```
whatsapp-mcp whatsapp-bridge/ 桥梁
│ ├── main.go
│ ├── go go.sum
│ └──.py # 网页二维码服务器（:8899）
├── whatsapp-mcp-server/ # Python MCP 服务器
│ ├── main.py
│ ├── whatsapp.py
│ ├── audio.py
│ └── pyproject.toml
├── webhook_listener.py # Bedrock 自动回复
├── start_webhook.sh
├── setup.sh # 一键设置
└── README.md
```
---
## 故障排除
| 问题 ||-------|----------|
| 405 错误 | 更新 whats：`go get -u go.mau.fi/whats && go build` |
|码不显示 | 重或使用 `python3 qr` |
| 消息不同 `store/*.db` 并重新链接手机 |
| 音 | 安装 FFmpegbrew install ffmpeg` |
---
致谢
基于 [/whatsapp-mcp](https.com/lharries/whatsapp 的自定义增强：
-rock Claude 的 webhook 自动文本 + 视觉）
- 的二维码配对服务器 更新的 whatsmeow（2026 年 6 月）
## 许可证
MIT
