GitHub（个人开源项目 finereli/whatsapp-mcp） · finereli
whatsapp-mcp：让 AI Agent 读取自己 WhatsApp 消息的只读 MCP 服务器
whatsapp-mcp：让 AI Agent 读取自己 WhatsApp 消息的只读 MCP 服务器是GitHub（个人开源项目 finereli/whatsapp-mcp）的免费开源项目（英文）。前置条件：需要会 TypeScript/Node.js 基础、了解命令行与 npm，并对 MCP 客户端与工具调用的基本概念有认识。
能理解并跑通一个自托管 MCP 服务器：在 Cloudflare Workers 上部署，用 Baileys 链接 WhatsApp 设备，把消息存入 Durable Object 中的 SQLite，并向 Claude Code 等 MCP 客户端暴露搜索、读取、命名等只读工具。
- 难度
- 见前置条件
- 类型
- 开源项目
- 语言
- 英文
- 规模
- 1 个课节
- 内容费用
- 免费
- 动手
- 需要动手环境
使用限制
阅读代码与文档只需浏览器；实际部署与使用需要 Cloudflare 付费账号、Node 环境和自己的 WhatsApp 账号。
- 练习与作业
- Cloudflare 账号需处于 Workers Paid 计划（网页写明每月几美元）自己的 WhatsApp 账号及手机，用于扫码链接设备支持 MCP 的客户端（如 Claude Code 或 Claude Desktop）用于连接 /mcp 端点
学完你能
- 说明该 MCP 服务器的架构：手机为数据源、服务器作为链接设备、消息存入 Cloudflare Durable Object 内的 SQLite
- 在自己的 Cloudflare 账号下用 Wrangler 完成 KV 命名空间、OWNER_PASSWORD 密钥配置与 npm run deploy 部署
- 把 WhatsApp 账号作为链接设备扫码接入，并观察首次历史导入进度
- 在 Claude Code 等 MCP 客户端中添加并登录 http 传输的 /mcp 端点
- 调用 list_chats、get_messages、search_messages、unnamed_chats、set_contact_names、sync_now、link_status、relink 等工具完成聊天检索与整理
- 让 Agent 借助已有联系人工具为只有号码的聊天补全名称并持久保存
- 识别该方案的合规与隐私边界：非官方接口、违反 WhatsApp 条款、仅限本人账号、只读不发送
适合你吗
适合
想学习 MCP 服务器实现、Agent 工具设计与 Serverless 部署的开发者，可以把这个项目当作完整可跑的参考实现。
暂不适合
只想系统学 AI Agent 理论、不打算注册 Cloudflare 付费计划或绑定自己 WhatsApp 账号的学习者不适合。
需要先会
需要会 TypeScript/Node.js 基础、了解命令行与 npm，并对 MCP 客户端与工具调用的基本概念有认识。
课程特点
- 内容侧重
- 侧重实践应用
- 练习与项目
- 先用小号或备份账号测试首次历史导入；重新导入需 relink 并再次扫码。媒体文件只显示占位标签，不含转写。不要用它发送消息。
- 学习时长
- 1 个课节原站未给出统一学习时长；实际用时取决于已有基础。
- 内容费用
- 免费仓库公开，README 正文即可直接读到全部功能说明与部署步骤，无付费墙；代码以 MIT 许可发布。
常见问题
免费吗？
免费：仓库公开，README 正文即可直接读到全部功能说明与部署步骤，无付费墙；代码以 MIT 许可发布。实践需要付费：网页写明需要 Cloudflare 账号的 Workers Paid 计划（每月几美元），因为导入大量历史时默认 CPU 限制不够用；作者表示未尝试免费计划。
需要什么基础？
需要会 TypeScript/Node.js 基础、了解命令行与 npm，并对 MCP 客户端与工具调用的基本概念有认识。软件、账号与硬件：Cloudflare 账号（Workers Paid 计划）、Node 20 或以上、一部可扫码的 WhatsApp 手机、一个支持 MCP 的客户端（如 Claude Code 或 Claude Desktop）。
有中文吗？
本站记录的语言是英文；是否有中文字幕或译本本站未核实，请以原站为准。
怎么开始？
从原始资源入口开始：https://github.com/finereli/whatsapp-mcp。本页“学前准备”列出环境与工具，“学习指南”给出开课提示词，可以在自己的电脑上按步骤开始。开课提示词尚未完整验证。练习与作业需要自备：Cloudflare 账号需处于 Workers Paid 计划（网页写明每月几美元）、自己的 WhatsApp 账号及手机，用于扫码链接设备、支持 MCP 的客户端（如 Claude Code 或 Claude Desktop）用于连接 /mcp 端点。
来源与使用须知
- 收录时间
- 本站首次收录 2026-10-22
- 指南参考
- 课程主页
版权与转载
- MIT：代码可自由使用和修改，需保留版权声明。原站说明
- 本站只提供原始链接和学习指南，不转载、不镜像课程材料；引用时请注明原作者与出处。