ClaudeMap

WhatsApp MCP

只读的 WhatsApp MCP server:agent 能搜索、能读你自己的聊天记录,一条消息也发不出去——托管免费版或 Cloudflare 自托管

MCP 服务器whatsappmcpread-onlyprivacyopen source

whatsapp-mcp 是架在你自己 WhatsApp 消息历史上的只读 MCP server:像登录 WhatsApp Web 那样用关联设备协议绑一次手机,之后任何 MCP 客户端都能搜索、读取你的会话,而它发不出任何消息。数据加密存储、开源(MIT)。两条使用路径:托管版 whatsapp.finereli.com(免费 beta、名额有限——Google 登录、扫码、把 /mcp 端点加进 agent 即可;静态加密,但运营方就是登录服务的运营者,README 明说「原则上能推导你的 key」);或在 Cloudflare Workers 上跑自己的副本(大历史导入需 Workers 付费版,约 5 美元/月;Node 20+;KV 建命名空间、OWNER_PASSWORD 设密码、npm run deploy)。同步语义:读取工具发现存量超过十分钟会先向 WhatsApp 补齐;没有后台拉取——数据 key 只在有人登录时存在;几周不用的账号可能丢失 WhatsApp 为关联设备暂存的消息,需重新绑定做全量再同步。撰稿时 404 星。

它做什么

  • 构造上只读:任何 MCP 客户端都能搜索、读取你的 WhatsApp 历史,而它发不出任何消息
  • whatsapp.finereli.com 托管免费 beta——Google 登录、像 WhatsApp Web 一样扫码绑定、把 /mcp 端点加进 agent
  • Cloudflare Workers 自托管:KV 存登录令牌、OWNER_PASSWORD 锁你的消息、npm run deploy 部署
  • 静态加密,每账户一个数据 key、由登录服务独持的 secret 派生——README 明说了诚实边界:登录服务的运营者原则上能推导所有 key
  • 读取时同步:存量超过十分钟即可读工具会先向 WhatsApp 补齐;没有后台拉取——key 只在有人登录时存在

什么时候用

想让 agent 从自己的聊天记录里答问题的人——我答应过谁什么、X 事我们定在哪天、找出别人发来的那个地址——同时不给任何发送能力,也不必把聊天记录整段贴进提示词。

如何上手

# 托管版(免费 beta):把 https://whatsapp.finereli.com/mcp 加进你的 MCP 客户端,然后用手机扫码

# 或自托管(Cloudflare Workers;大历史导入需 Workers 付费版,约 5 美元/月;Node 20+):
git clone https://github.com/finereli/whatsapp-mcp && cd whatsapp-mcp
npm install
npx wrangler kv namespace create OAUTH_KV      # 把打印出的 id 填进 wrangler.jsonc
npx wrangler secret put OWNER_PASSWORD         # 12 字符以上;这就是锁你消息的密码
npm run deploy

# 然后打开你的 workers.dev 地址:用密码登录、扫码(设置、已关联的设备),
# 再把 MCP 客户端指向 https://your-url/mcp

注意事项

只读,但聊天记录是敏感数据:托管 beta 的运营方就是登录服务运营者,README 原话是他们原则上能推导你的 key——不能接受就跑自己的副本(这也是 README 自己给出的建议)。大历史导入需要 Workers 付费版;作者自述免费版计划下首次导入比较脆弱。几周不用的账号可能丢了 WhatsApp 为关联设备暂存的消息——重新绑定并全量再同步。撰稿时 404 星(2026-11-06)。MIT。

代码仓库

finereli/whatsapp-mcp

收录日期

地图上的相关资源

  • Blitz Strike

    MCP 服务器

    把渗透测试方法论装进一个 MCP server:BLITZ 摸清攻击面,EAGLE-EYE 追 source-to-sink,STRIKE 对每条发现先实测再上报。

    • mcp-server
    • security
    • pentest
    • methodology
  • Ripwire

    MCP 服务器

    Red Hat 出品的「AI 上下文版 ripgrep」——C++23 零依赖 CLI,同时讲 MCP。

    • mcp
    • code-context
    • cli
    • red-hat
  • Deja Vu

    MCP 服务器

    让 25+ 个编码 agent 共享同一份会话记忆——Claude Code、Codex、Cursor 终于记得同一个项目。

    • mcp
    • memory
    • cross-agent
    • context