Show HN: WhatsApp MCP 服务器
Hacker News 摘要原标题:Show HN: WhatsApp MCP Server
该页面介绍了一个名为WhatsApp MCP Server的开源项目。该项目是一个用于WhatsApp的模型上下文协议(MCP)服务器,用户可以通过该服务器搜索个人WhatsApp消息、查找联系人以及向单个或群组发送消息。它直接通过WhatsApp Web的多设备API连接到用户的个人WhatsApp账户,并使用whatsmeow库来实现功能。所有的消息都存储在本地的SQLite数据库中,只有在用户控制的情况下,才会发送给如Claude这样的语言模型。
项目特点和使用功能包括:
1. 可以通过Claude与WhatsApp联系人互动,利用Claude的AI能力进行对话。
2. 支持以下工具与WhatsApp交互:
• search_contacts:按姓名或电话号码搜索联系人。
• list_messages:检索消息,可选择性应用过滤和上下文。
• list_chats:列出可用的聊天记录及其元数据。
• get_chat:获取特定聊天的信息。
• get_direct_chat_by_contact:查找与特定联系人的直接聊天。
• get_contact_chats:列出与特定联系人的所有聊天。
• get_last_interaction:获取与某联系人的最近消息。
• get_message_context:检索特定消息的上下文。
• send_message:向指定电话号码发送WhatsApp消息。
安装和使用步骤:
1. 确保安装Go、Python 3.6及以上版本,以及Anthropic Claude Desktop应用程序。
2. 克隆该项目的GitHub仓库,并进入相应的目录。
3. 运行WhatsApp桥接应用并进行二维码扫描以完成认证。
4. 根据指定路径配置MCP服务器的JSON文件,并将其保存到相关配置目录。
5. 重启Claude Desktop或Cursor以完成集成。
架构概述:
• Go WhatsApp Bridge:通过WhatsApp Web API连接,处理二维码认证,并在SQLite中存储消息历史。
• Python MCP Server:实现MCP协议的Python服务器,提供与WhatsApp数据交互的标准工具。
数据存储:
所有消息历史存储在whatsapp-bridge/store/目录下的SQLite数据库中。
故障排除指南:
• 如果在运行时遇到权限问题,可能需要将程序添加到PATH中或使用可执行文件的完整路径。
• 确保Go应用程序和Python服务器同时运行以实现集成。
常见认证问题:
• QR码未显示或WhatsApp已登录情况下的操作提示。
• 消息加载延迟的问题及解决方法。
总的来说,该项目为WhatsApp用户提供了一种利用AI技术更高效地管理和使用WhatsApp消息的方式。