由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名
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 以支持音频消息自动转换
