whatsapp-mcp

概述

这个 MCP 服务器提供全面的 WhatsApp 集成，允许 Claude 搜索联系人、读取和发送消息（文本、图片、视频、文档和音频）、管理聊天记录和下载媒体。它包含两个组件：连接到 WhatsApp 的 Go 桥接器和将功能暴露给 Claude 的 Python MCP 服务器。所有消息都存储在本地 SQLite 中，仅在明确请求时才会与 Claude 共享。

试试问 AI

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

• search_contactsquery: string

  Search contacts by name or phone number

  试试:Find contacts named John试试:Search for phone number 555-1234试试:Who has the phone number starting with +1?
• get_contactidentifier: string

  Resolve a WhatsApp contact name from a phone number, LID, or full JID

  试试:What's the name for phone number 5551234567?试试:Look up who owns this number试试:Who is 184125298348272@lid?
• list_messageschat_jid?: string, limit?: number, before_date?: string, after_date?: string, sort_by?: 'newest' | 'oldest'

  Get messages with filters, date ranges, and sorting

  试试:Show me the last 100 messages from today试试:Get messages from the family group chat试试:Find messages from last week
• send_messagerecipient: string, message: string

  Send a text message to a contact or group

  试试:Send 'Hello!' to +1234567890试试:Message the team group saying 'Meeting at 3pm'
• send_filerecipient: string, file_path: string, caption?: string

  Send a media file (image, video, document)

  试试:Send the document to John试试:Send the vacation photo to mom with caption 'Beautiful view!'
• send_audio_messagerecipient: string, file_path: string

  Send a voice message (automatically converts to Opus .ogg format)

  试试:Send a voice message to +1234567890试试:Send an audio note to the team group
• download_mediamessage_id: string, chat_jid: string

  Download media from a received message

  试试:Download the media from message abc123试试:Save the video from the group chat
• list_chatslimit?: number

  List all chats with metadata

  试试:List all my chats试试:Show me the last 20 chats
• get_chatjid: string

  Get specific chat metadata by JID

  试试:Get info for the family group chat试试:Show details for chat 12025551234@s.whatsapp.net
• get_direct_chat_by_contactphone: string

  Find a direct message chat with a contact

  试试:Find my DM with John试试:Get the direct chat with 5551234567
• get_message_contextmessage_id: string, chat_jid: string, before?: number, after?: number

  Get messages around a specific message for context

  试试:Show me messages around message abc123试试:Get context for message xyz456 with 5 messages before and after
• get_last_interactionphone: string

  Get the last message exchanged with a contact

  试试:What was the last message from John?试试:Show me my last conversation with 5551234567

可对比工具

安装

FAQ

我可以读取和发送哪些类型的消息？

您可以读取和发送文本消息、图片、视频、文档和音频消息。服务器还支持自动转换为 Opus .ogg 格式的语音消息。

消息如何存储和保障安全？

所有消息都存储在本地 SQLite 数据库中。桥接器使用令牌身份验证进行 API 调用，并将媒体文件访问限制在指定目录。消息仅在您明确允许时才会发送给 Claude。

whatsapp-mcp 对比