关键词

WhatsApp集成LLM上下文消息检索联系人管理工具服务器

使用说明

项目简介

WhatsApp MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接大型语言模型 (LLM) 与用户的个人 WhatsApp 账号。通过此服务器，LLM 如 Claude 可以安全地访问和操作您的 WhatsApp 数据，实现例如消息检索、联系人查询和消息发送等功能。所有消息数据本地存储，仅在 LLM 通过工具访问时才会传递给 LLM，确保用户数据隐私和安全。

主要功能点

  • 消息检索: 支持按关键词、日期范围、发送者或聊天对象检索 WhatsApp 消息。
  • 联系人管理: 允许 LLM 搜索联系人姓名或电话号码，获取联系人信息。
  • 聊天管理: 支持列出和搜索 WhatsApp 聊天会话，获取聊天会话的元数据。
  • 上下文感知: 可以获取特定消息的上下文信息，包括消息前后的对话内容。
  • 消息发送: 允许 LLM 通过指定电话号码发送 WhatsApp 消息。

安装步骤

  1. 克隆仓库

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

  2. 运行 WhatsApp 桥接程序 进入 'whatsapp-bridge' 目录并运行 Go 应用程序：

    cd whatsapp-bridge
go run main.go

    首次运行时，程序会提示扫描二维码进行 WhatsApp 账号认证。请使用您的 WhatsApp 手机应用扫描终端中显示的二维码。认证信息会被本地保存，大约 20 天后可能需要重新认证。

  3. 配置 MCP 客户端 (以 Claude Desktop 为例) 复制仓库中的 'claude_desktop_config.example.json' 文件内容，根据您的实际路径进行修改，并保存为 'claude_desktop_config.json' 文件到 Claude Desktop 的配置目录（通常为 '~/Library/Application Support/Claude/' 或 '%APPDATA%/Claude/'）。

    服务器配置 (claude_desktop_config.json 内容示例)

    {
  "mcpServers": {
    "whatsapp": {
      "command": "{{PATH}}/.local/bin/uv",
      "args": [
        "--directory",
        "{{PATH}}/whatsapp-mcp/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}
    • 'server name': 'whatsapp' (MCP 客户端中用于标识此服务器的名称，您可以自定义，例如 'my_whatsapp_server' )
    • 'command': '{{PATH}}/.local/bin/uv' (启动服务器的命令，这里使用 'uv' 包管理器来运行 Python 脚本。'{{PATH}}' 需要替换为您的 'uv' 可执行文件的完整路径。)
    • 'args': 启动参数列表
      • '--directory': '{{PATH}}/whatsapp-mcp/whatsapp-mcp-server' (指定 Python 服务器代码所在的目录。'{{PATH}}' 需要替换为您的 'whatsapp-mcp' 仓库的完整路径。)
      • 'run': 'main.py' (指定要运行的主服务器脚本。)

  4. 重启 Claude Desktop 重启 Claude Desktop 应用程序，您应该能在集成选项中看到 WhatsApp，并可以开始使用。

基本使用方法

完成安装和配置后，在 Claude Desktop 中选择 WhatsApp 集成，即可通过自然语言指令，利用 Claude 的 AI 能力与您的 WhatsApp 数据进行交互。例如，您可以让 Claude 搜索特定联系人的聊天记录、总结最近的对话内容，或者发送 WhatsApp 消息。

信息

分类

通信与社交

访问项目