whatsapp-mcp

开源项目（github.com/lharries/whatsapp-mcp，MIT 许可，约 6.1 千星），把个人 WhatsApp 接进 Claude Desktop、Cursor 等 MCP 客户端：搜联系人、翻消息与媒体、给个人或群发送文本、图片、视频、文档和语音。它由 Go 桥接程序基于 whatsmeow 库走 WhatsApp Web 多设备接口连接你自己的账号，首次扫码登录，消息全量落在本地 SQLite，只有 Agent 通过工具主动读取时才会送给模型。需要注意：仓库最近一次提交在 2025 年 7 月，且 README 自己就提示了提示注入导致私人数据外泄的风险。定价：免费，MIT 许可开源自托管；成本只发生在你使用的模型侧（如 Claude 订阅或 API 调用）。编辑评分：⭐ 4.0。

4.0

(17 评价)

1.0万浏览

免费可用

Web

whatsapp-mcp 是什么？

whatsapp-mcp是什么？核心功能版本/套餐对比值不值得用？使用建议适合谁用？ whatsapp-mcp 是一个开源项目（github.com/lharries/whatsapp-mcp，MIT 许可，约 6.1 千星，2025 年 3 月建库），作用是把你个人的 WhatsApp 变成 Agent 能读能写的一个工具。接上之后，Claude Desktop 或 Cursor 里的 Agent 可以搜联系人、翻你的聊天记录（含图片、视频、文档、语音），也能给个人或群发消息和媒体文件。作者的动机写得很实在：你 99% 的生活都在 WhatsApp 里，把 LLM 接上，它才算拿到了完整上下文。实现是两段式的。一个 Go 写的桥接程序基于 whatsmeow 库走 WhatsApp Web 多设备接口连你的账号，首次运行时终端里出二维码，用手机扫一下完成认证，之后它负责把聊天与消息写进本地 SQLite；另一头是 Python 写的 MCP server，把这些数据包装成标准 MCP 工具给客户端调用。整条链路不依赖任何第三方 API，也不需要申请 WhatsApp Business API——这是它和多数商业方案最根本的区别。数据流向值得单独说：消息存在本机 SQLite，只有当 Agent 通过工具去读时才会送到模型那边，读什么由你控制。没有付费档。它是 MIT 许可的开源项目，自己跑、完全免费，唯一的花费在模型那一侧（Claude 订阅或 API 调用）。跨平台方面有个坑要提前知道：Windows 上 go-sqlite3 需要 CGO，项目文档给的解法是装 C 编译器（推荐 MSYS2，把 ucrt64\bin 加进 PATH），然后 go env -w CGO_ENABLED=1 再跑，否则会直接报 CGO_ENABLED=0 的错。先说它好在哪。思路上它是对的：不绕商业 API、不上云，直接借 WhatsApp Web 的多设备通道接你自己的账号，数据留在本地 SQLite，模型只看你允许它看的部分。工具设计也务实，get_message_context、get_last_interaction 这种粒度明显是真用过的人设计的——找一条旧消息的来龙去脉，比笼统的「搜索」有用得多。代码只有 Go 桥接加 Python server 两块，想改想加自己动手门槛不高，这也是它衍生出一堆 fork 的原因。

消息检索：list_messages 按条件翻历史，get_message_context 取某条消息前后文，get_last_interaction 查和某人最近一次往来。
会话与联系人：list_chats 列会话及元信息，get_chat、get_direct_chat_by_contact、get_contact_chats、search_contacts 按名字或号码找人找群。
发送能力：send_message 发文本，send_file 发图片、视频、文档、音频，个人和群聊都支持。
语音消息：装了 FFmpeg 之后会自动把非 Opus 音频转成 .ogg Opus，对方收到的是可播放的语音条；没装 FFmpeg 也能用 send_file 发原始音频。
本地存储与索引：桥接程序在 whatsapp-bridge/store/ 下维护 SQLite，chats 与 messages 分表并建索引，搜索够快。
客户端接入：把一段 mcpServers 配置写进 Claude Desktop 的 claude_desktop_config.json 或 Cursor 的 mcp.json，重启就能看到 WhatsApp 集成。