lharries/whatsapp-mcp
GitHub: lharries/whatsapp-mcp
WhatsApp MCP 服务器让 AI 助手能够搜索、阅读和发送个人 WhatsApp 消息与媒体,并通过本地 SQLite 保障数据隐私。
Stars: 5633 | Forks: 1033
# WhatsApp MCP 服务器
这是一个用于 WhatsApp 的模型上下文协议(MCP)服务器。
通过它,您可以搜索和阅读您的个人 WhatsApp 消息(包括图像、视频、文档和音频消息),搜索您的联系人,并向个人或群组发送消息。您还可以发送媒体文件,包括图像、视频、文档和音频消息。
它通过 WhatsApp 网页多设备 API 直接连接到您的**个人 WhatsApp 账户**(使用 [whatsmeow](https://github.com/tulir/whatsmeow) 库)。您的所有消息都本地存储在 SQLite 数据库中,并且仅当代理通过工具(由您控制)访问它们时才会发送给 LLM(例如 Claude)。
以下是将其连接到 Claude 后您可以执行的操作示例。

## 安装说明
### 前置条件
- Go
- Python 3.6+
- Anthropic Claude Desktop 应用程序(或 Cursor)
- UV(Python 包管理器),使用 `curl -LsSf https://astral.sh/uv/install.sh | sh` 安装
- FFmpeg(*可选*)- 仅用于音频消息。如果您想将音频文件作为可播放的 WhatsApp 语音消息发送,它们必须采用 `.ogg` Opus 格式。安装 FFmpeg 后,MCP 服务器将自动转换非 Opus 音频文件。如果没有 FFmpeg,您仍然可以使用 `send_file` 工具发送原始音频文件。
### 步骤
1. **克隆此仓库**
git clone https://github.com/lharries/whatsapp-mcp.git
cd whatsapp-mcp
2. **运行 WhatsApp 桥接服务**
导航到 whatsapp-bridge 目录并运行 Go 应用程序:
cd whatsapp-bridge
go run main.go
首次运行时,系统会提示您扫描二维码。使用您的 WhatsApp 移动应用程序扫描二维码进行身份验证。
大约 20 天后,您可能需要重新进行身份验证。
3. **连接到 MCP 服务器**
复制以下 JSON 并填入相应的 {{PATH}} 值:
{
"mcpServers": {
"whatsapp": {
"command": "{{PATH_TO_UV}}", // 运行 `which uv` 并将输出结果放在这里
"args": [
"--directory",
"{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server", // 进入仓库目录,运行 `pwd` 并将输出结果加上 "/whatsapp-mcp-server" 填入此处
"run",
"main.py"
]
}
}
}
对于 **Claude**,请将其保存为 `claude_desktop_config.json`,放在您的 Claude Desktop 配置目录中
标签:Claude, CVE检测, DLL 劫持, EVTX分析, Go, LLM工具, MCP, Model Context Protocol, Python, RAG, Ruby工具, SQLite, WhatsApp, whatsmeow, 信息检索, 即时通讯, 大语言模型, 媒体处理, 开源, 无后门, 日志审计, 本地存储, 桌面应用, 消息提取, 社交网络, 网络调试, 自动化, 自动化助手, 跨平台API, 逆向工具, 通讯软件