5分钟上手 WhatsApp MCP
快速搭建 WhatsApp MCP 服务器，让 Claude AI 助手能够读取和发送你的 WhatsApp 消息
环境要求
支持的操作系统
运行环境
所需工具
克隆项目仓库
Python 包管理器
AI 客户端（或 Cursor）
操作步骤
安装前置依赖
安装 UV 包管理器和项目依赖
curl -LsSf https://astral.sh/uv/install.sh | shgit clone https://github.com/lharries/whatsapp-mcp.git
cd whatsapp-mcpWindows 用户需要先安装 MSYS2 和 C 编译器，并设置 CGO_ENABLED=1
启动 WhatsApp 桥接服务
运行 Go 应用程序连接 WhatsApp
cd whatsapp-bridge
go run .预期结果：终端会显示一个二维码，用手机 WhatsApp 扫描登录
首次运行需要扫码登录，之后会自动重连
配置 MCP 服务器
创建 Claude Desktop 配置文件
预期结果：创建配置文件后重启 Claude Desktop
对于 Claude Desktop，配置文件路径：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）
配置 MCP 连接
将以下配置添加到 Claude Desktop 配置文件中
预期结果：Claude Desktop 重启后显示 WhatsApp 集成可用
确保替换 {{PATH}} 为你的实际项目路径
验证成功
确认 WhatsApp MCP 服务器正常运行
快速提示
Windows 用户必须设置 CGO_ENABLED=1 并安装 C 编译器
首次登录后需要等待几分钟加载历史消息
会话大约 20 天后需要重新扫码登录
常见问题
二维码不显示
重启 Go 应用程序，检查终端是否支持显示二维码
Claude 中看不到 WhatsApp 集成
检查配置文件路径是否正确，确保两个服务都在运行
Windows 编译错误
安装 MSYS2，添加 ucrt64\bin 到 PATH，设置 CGO_ENABLED=1
下一步
尝试发送第一条消息
在 Claude 中使用 sendmessage 工具发送测试消息
探索搜索功能
使用 searchcontacts 和 listmessages 工具查找联系人历史
配置媒体支持
安装 FFmpeg 以支持音频消息自动转换
相关项目推荐
avelino/awesome-go
一份精选的Go语言优秀框架、库及软件列表
ollama/ollama
开始使用OpenAI gpt-oss、DeepSeek-R1、Gemma 3及其他模型。
golang/go
Go 编程语言
kubernetes/kubernetes
生产级容器调度与管理平台
fatedier/frp
一款快速反向代理，可帮助您将NAT或防火墙后的本地服务器暴露至互联网。
gin-gonic/gin
Gin 是一个用 Go (Golang) 编写的 HTTP Web 框架。它提供了类似 Martini 的 API，但性能更优——速度提升高达 40 倍。如果您需要出色的性能，请使用 Gin。