Gopal Shivapuja的增强型WhatsApp MCP服务器
此存储库是 WhatsApp MCP服务器 卢克·哈里斯。它包括额外的自动化脚本，用于轻松设置、自动启动、自我监控和自动二维码身份验证，由以下人员定制和维护 戈帕尔·希瓦普贾.
信用： - 增强、自动化和个性化： 戈帕尔·希瓦普贾
这有什么作用
此WhatsApp MCP服务器允许您：
- 将您的WhatsApp帐户连接到Claude等人工智能助手
- 从您的AI助手搜索并阅读您的WhatsApp消息
- 通过您的AI助手通过WhatsApp发送消息和媒体
- 自动处理保持服务运行
增强功能（Gopal Shivapuja）
此版本对原始项目进行了多项改进：
- 自动启动：当您的系统启动时，WhatsApp桥会自动启动
- 日常自检：系统每天检查一次服务是否正在运行，并在需要时重新启动
- 二维码验证：当您的会话到期时（通常在20多天后），系统会自动显示一个二维码以进行重新身份验证
- 系统通知：当需要采取行动时，您会收到通知
- 综合录井：所有活动都已正确记录，便于故障排除
- 自动设置：依赖性检查和自动Python包安装
安装
先决条件
- macOS（自动化脚本是为macOS设计的）
- 去
- Python 3.6+
- UV或pip Python包管理器（安装脚本将检查并使用可用的任何一个）
- FFmpeg（可选）-仅用于发送语音消息
分步安装
- 克隆此存储库
git clone https://github.com/gopalshivapuja/personal-whatsapp-mcp.git
cd personal-whatsapp-mcp- 运行WhatsApp桥进行初始设置
cd whatsapp-bridge
go run main.go使用WhatsApp移动应用程序扫描二维码进行身份验证。
- 运行自动化设置脚本
cd ..
bash automation/setup.sh这将：
- 检查所有必需的依赖项（Go、Python等） - 如果UV或pip可用，则自动安装Python要求 - 创建启动代理以在系统启动时运行服务 - 设置一个日常监视程序，检查服务是否正在运行 - 配置需要重新验证时自动显示二维码 - 立即启动WhatsApp网桥
- 连接到Claude或其他AI助手
复制此JSON配置，根据需要替换路径：
{
"mcpServers": {
"whatsapp": {
"command": "/path/to/uv", // Run `which uv` to find this
"args": [
"--directory",
"/path/to/personal-whatsapp-mcp/whatsapp-mcp-server", // Use full path
"run",
"main.py"
]
}
}
}对于Claude Desktop，请将其另存为： ~/Library/Application Support/Claude/claude_desktop_config.json
对于游标，请将其另存为： ~/.cursor/mcp.json
自动化是如何工作的
自动脚本
该项目在 automation/ 目录：
- setup.sh：检查依赖关系、安装要求和设置LaunchAgent的主安装脚本
- 卸载.sh：安全地删除自动化，同时保留您的WhatsApp数据
- start-whatsapp-bridge.sh：如果WhatsApp桥未运行，请手动启动它
- 检查并重新启动-bridge.sh：监控桥，如果桥停止，则自动重新启动
- check-qr-auth.sh：检测何时需要身份验证并显示二维码
自动启动
WhatsApp桥配置为在您的系统通过macOS启动代理启动时自动启动。
看门狗服务
每天一次，在系统启动时，看门狗脚本会检查WhatsApp网桥是否正在运行。如果没有，监视器会自动重新启动并记录操作。
QR身份验证助手
当您的WhatsApp会话到期时（通常在20多天后），系统：
- 检测到需要重新身份验证
- 打开显示二维码的终端窗口
- 显示系统通知
- 扫描代码后自动恢复正常操作
记录系统
所有操作都记录到：
- WhatsApp桥：
~/Library/Logs/whatsapp-mcp.log - 错误日志：
~/Library/Logs/whatsapp-mcp-error.log - 监视器日志：
~/Library/Logs/whatsapp-mcp-watchdog.log
管理服务
检查状态
要确认服务正在运行：
launchctl list | grep whatsapp查看日志
tail -f ~/Library/Logs/whatsapp-mcp.log手动启动
如果需要手动启动网桥：
bash automation/start-whatsapp-bridge.sh卸载
要删除自动化但保留数据，请执行以下操作：
bash automation/uninstall.sh故障排除
二维码未显示
如果您需要强制显示二维码：
cd whatsapp-bridge
go run main.go桥未启动
检查日志中的错误消息：
cat ~/Library/Logs/whatsapp-mcp-error.log身份验证问题
如果您在身份验证方面遇到问题：
- 删除数据库文件：
rm whatsapp-bridge/store/*.db - 重新启动网桥：
cd whatsapp-bridge && go run main.go - 用手机扫描二维码
依赖性问题
如果在安装过程中遇到有关缺少依赖项的错误：
- 确保已安装Go：
go version - 请确保已安装Python 3：
python3 --version - 对于Python包问题，您可以手动安装依赖项：
pip install -r whatsapp-mcp-server/requirements.txt迁移到新计算机
要在新计算机上设置此系统，请执行以下操作：
- 安装先决条件（Go、Python）
- 克隆此存储库
- 运行安装脚本：
bash automation/setup.sh - 提示时使用WhatsApp进行身份验证
- 如上所述配置Claude或您的AI助手
技术细节
自动化组件
该系统由三个主要部分组成：
- 主要WhatsApp桥接服务
- 启动WhatsApp连接 - 处理消息同步 - 提供MCP服务器接口
- 看门狗服务
- 每天运行一次，在系统启动时运行 - 检查网桥是否正在运行 - 如果需要，自动重新启动它
- QR身份验证助手
- 每天运行一次，在系统启动时运行 - 监控身份验证请求的日志 - 需要时显示二维码
文件位置
- 发射代理：
~/Library/LaunchAgents/com.user.whatsapp-mcp*.plist - 日志文件：
~/Library/Logs/whatsapp-mcp*.log - 数据库：
whatsapp-bridge/store/*.db - 脚本：
automation/*.sh
致谢和确认
- 原始WhatsApp MCP服务器：由卢克·哈里斯创建。请访问 原始存储库 有关核心功能的更多信息。
- WhatsApp连接：基于Tulir Asokan的whatsmow图书馆。
- 增强、自动化和个性化：戈帕尔·希瓦普贾
本项目按原样提供，不提供保修。请按照WhatsApp的服务条款负责任地使用。