whatsapp-mcp

概述

这个 MCP 服务器通过模型上下文协议（MCP）暴露 7 个工具、4 个提示和 4 个资源，连接 WhatsApp 和 AI 助手。它使用非官方的 whatsmeow 库连接 WhatsApp Web，将所有消息存储在 SQLite 数据库中。服务器提供全面的搜索功能、时区支持和安全的 API 密钥认证。通过 Docker 和本地安装选项，它可以与 Claude Desktop 等 MCP 兼容客户端无缝集成。

试试问 AI

装完之后，这里有 7 个你可以让 AI 做的事：

• list_chats

  Browse WhatsApp conversations ordered by recent activity

  试试:Show me my recent conversations试试:List all my WhatsApp chats
• get_chat_messages

  Read messages from a specific chat with pagination and sender filtering

  试试:Get messages from the Tech Team group试试:Show recent messages from Maria
• search_messages

  Search across all chats with pattern matching and wildcards

  试试:Search for messages about budget meeting试试:Find all messages containing 'deadline'
• find_chat

  Locate a chat by name with fuzzy search support

  试试:Find the chat with João试试:Show me the Tech Team conversation
• send_message

  Send WhatsApp messages to any chat or group

  试试:Tell Maria I'll be 10 minutes late试试:Send a message to the work group about the meeting
• load_more_messages

  Fetch older message history from WhatsApp servers on demand

  试试:Load more messages from last week试试:Get the conversation history from last month
• get_my_info

  Get your WhatsApp profile information including JID, name, status, and picture

  试试:Show my WhatsApp profile试试:Get my WhatsApp account details

可对比工具

安装

git clone https://github.com/felipeadeildo/whatsapp-mcp
cd whatsapp-mcp
cp .env.example .env
# 编辑 .env 文件设置您的配置

docker compose up -d

{
  "mcpServers": {
    "whatsapp": {
      "url": "http://localhost:8080/mcp/您的-密钥",
      "transport": "http"
    }
  }
}

FAQ

这是官方的 WhatsApp 项目吗？

不是，这是一个非官方项目，使用 WhatsApp 的非官方 Web API。它与 WhatsApp 或 Meta 无关。

消息存储在哪里？

所有消息都存储在 ./data/ 目录的 SQLite 数据库中。媒体文件存储在 ./data/media/ 目录中。

认证如何工作？

您用 WhatsApp 扫描二维码来链接设备，然后使用 API 密钥进行 MCP 客户端认证。

whatsapp-mcp 对比