AI导哈

WhatsApp自动化桥接服务

增强版WhatsApp MCP服务器，提供自动化启动、会话维护及AI助手集成功能，适用于个人自动化消息管理场景。

  • by gopalshivapuja
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 gopalshivapuja/personal-whatsapp-mcp

使用说明

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（可选）-仅用于发送语音消息

分步安装

  1. 克隆此存储库

    git clone https://github.com/gopalshivapuja/personal-whatsapp-mcp.git
cd personal-whatsapp-mcp

  2. 运行WhatsApp桥进行初始设置

    cd whatsapp-bridge
go run main.go

    使用WhatsApp移动应用程序扫描二维码进行身份验证。

  3. 运行自动化设置脚本

    cd ..
bash automation/setup.sh

    这将：

    • 检查所有必需的依赖项（Go、Python等）
    • 如果UV或pip可用，则自动安装Python要求
    • 创建启动代理以在系统启动时运行服务
    • 设置一个日常监视程序，检查服务是否正在运行
    • 配置需要重新验证时自动显示二维码
    • 立即启动WhatsApp网桥

  4. 连接到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
  • 用手机扫描二维码

依赖性问题

如果在安装过程中遇到有关缺少依赖项的错误：

  1. 确保已安装Go： go version
  2. 请确保已安装Python 3： python3 --version
  3. 对于Python包问题，您可以手动安装依赖项：
    pip install -r whatsapp-mcp-server/requirements.txt

迁移到新计算机

要在新计算机上设置此系统，请执行以下操作：

  1. 安装先决条件（Go、Python）
  2. 克隆此存储库
  3. 运行安装脚本： bash automation/setup.sh
  4. 提示时使用WhatsApp进行身份验证
  5. 如上所述配置Claude或您的AI助手

技术细节

自动化组件

该系统由三个主要部分组成：

  1. 主要WhatsApp桥接服务

    • 启动WhatsApp连接
    • 处理消息同步
    • 提供MCP服务器接口

  2. 看门狗服务

    • 每天运行一次，在系统启动时运行
    • 检查网桥是否正在运行
    • 如果需要，自动重新启动它

  3. 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的服务条款负责任地使用。

相关 MCP