让 AI 掌控你的 WhatsApp：go-whatsapp-mcp 深度解析与实战指南

icy 昨天 29 抢沙发

默认

摘要： 赋予 LLM 社交能力：go-whatsapp-mcp 深度解析在当前大模型（LLM）的生态中，Claude 提出的 MCP (Model Context Protocol) 正...

赋予 LLM 社交能力：go-whatsapp-mcp 深度解析

在当前大模型（LLM）的生态中，Claude 提出的 MCP (Model Context Protocol) 正在改变 AI 与外部工具交互的方式。而 go-whatsapp-mcp 则是将这一协议应用于全球最流行通讯软件 WhatsApp 的绝佳实践。

简单来说，这个项目通过 Go 语言实现了一个 MCP 服务器，它充当了 AI 模型（如 Claude Desktop）与 WhatsApp 账户之间的“翻译官”。通过它，你的 AI 助手不再仅仅能写代码或分析文档，而是能够直接读取你的聊天记录、发送消息以及管理联系人。

🛠️ 核心技术架构

go-whatsapp-mcp 的实现逻辑可以分为三层：

MCP 协议层：遵循 Anthropic 定义的标准，通过 JSON-RPC 与 LLM 客户端通信，定义了 AI 可以调用的 tools（工具集）。
Go 逻辑层：处理并发请求、身份验证以及将 MCP 指令转换为 WhatsApp API 调用。
WhatsApp 接口层：利用 WhatsApp 的 Web 协议或相关 API 实现对账户的实际控制。

核心功能点

消息读取：允许 AI 检索特定联系人的最新对话，为 AI 提供实时上下文。
消息发送：AI 可以根据指令直接向指定用户发送文本消息。
联系人管理：查询联系人列表，确保 AI 能够准确找到目标发送对象。
自动化流：结合 LLM 的推理能力，实现“监控某人消息 \(\rightarrow\) 分析意图 \(\rightarrow\) 自动回复”的闭环。

🚀 快速上手指南

1. 环境准备

安装 Go (1.21 或更高版本)
安装 Claude Desktop (目前 MCP 协议最主流的客户端)
一个活跃的 WhatsApp 账号

2. 安装与编译

克隆仓库并编译二进制文件：

text

git clone https://github.com/lharries/whatsapp-mcp
cd whatsapp-mcp
go build -o whatsapp-mcp .

3. 配置 Claude Desktop

你需要将该服务器添加到 Claude 的配置文件中（通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 对应路径）：

json

{
  "mcpServers": {
    "whatsapp": {
      "command": "/path/to/your/whatsapp-mcp",
      "args": [],
      "env": {
        "WHATSAPP_SESSION": "your_session_data" 
      }
    }
  }
}

注：具体环境变量取决于项目的最新版本，通常需要通过扫描 QR 码获取 Session 凭证。

💡 实际应用场景实例

一旦配置完成，你可以在 Claude 的对话框中直接下达指令，AI 会自动调用 whatsapp-mcp 提供的工具。

场景一：智能信息汇总

用户指令：

“帮我检查一下今天来自 ‘张三’ 的所有 WhatsApp 消息，总结他提到的关于项目进度的关键点，并告诉我他是否在等待我的回复。”

AI 执行流程： 1. 调用 list_contacts \(\rightarrow\) 找到张三的 ID。 2. 调用 get_messages \(\rightarrow\) 获取今日对话记录。 3. LLM 分析文本 \(\rightarrow\) 提取关键点 \(\rightarrow\) 输出总结。