lharries/whatsapp-mcp

解决什么问题

WhatsApp 的聊天记录是很多人最完整的人际与工作档案，但它被锁在手机 App 里：没有像样的跨会话搜索，没有可供程序读取的接口。想让 AI 助手回答“上个月我们到底定了什么”或结合上下文起草回复，根本没有合规的接入点。这个项目做的就是这件事：Go 进程通过 WhatsApp Web 多设备协议登录你的账号，把消息镜像进本地 SQLite，再由 Python 的 MCP server 把这些数据包装成智能体可调用的工具。

有什么不同

常见的“和自己的聊天记录对话”方案依赖导出文件、截图或者个人账号根本不存在的云端 API。这里的路径是本地存储加 MCP 接口，任何支持 MCP 的客户端（Claude Desktop、Cursor）拿到的是同一套工具。架构上的取舍值得注意：Go 桥接层负责登录和同步，Python 层负责工具定义，两者分离让 WhatsApp 会话独立于智能体存活，没连 LLM 时历史依然可查。短板在凭据管理——它走的是“关联设备”机制，README 自己也说大约每 20 天可能需要重新认证。

适合谁

已经在自己机器上跑着 MCP 客户端、想让自己的 WhatsApp 数据进入其中的开发者，并且能接受维护一个由两个进程组成、需要常开的环境。它适合个人规模的归档，不适合团队部署。需要多用户访问、托管级可靠性或合规审计的人应该另找方案；同样不适合无法接受 README 已明确警示风险的人：一个同时持有私人数据和外发消息能力的 MCP server，正是 prompt injection 数据外泄的典型组合。

上手成本

需要 Go、Python 3.6+、uv，语音消息可选 FFmpeg。Windows 上 go-sqlite3 要求开启 CGO 并通过 MSYS2 安装 C 编译器，这通常是第一个卡住的地方。Go 桥和 Python server 必须同时运行，安装是手动 clone 加配置，JSON 里要填硬编码路径。协议是 MIT，仓库很年轻，README 对认证过期和同步错乱时需要删除本地数据库写得很坦诚。要有做些维护工作的心理准备，并把关联设备会话当成需要保护的凭据。

点评

这是一个专注的双语言胶水层，不是打磨过的产品；它的人气恰恰反映了大家有多想把聊天数据开放给智能体。Show HN 帖在 2025 年拿到 229 分和 138 条评论，仓库此后积累到约 6.7k star，月度 Go 榜 +418 说明热度仍在上升而非一日冲高。但维护负担是实打实的：WhatsApp 协议变动、会话过期、以及注入风险，全都落在用户身上。想要一个本地、可审查的桥接层并且愿意承担运维成本，就上；需要开箱即用或多租户方案，请绕道。