WhatsApp MCP Server (TypeScript/Baileys)

基本能力

产品定位

WhatsApp MCP Server 是一个用于连接个人 WhatsApp 账户与 AI 代理的工具，提供消息搜索、联系人管理、消息发送等功能。

核心功能

1. 搜索联系人：通过名称或电话号码部分搜索联系人。
2. 列出消息：检索特定聊天的消息历史，支持分页。
3. 列出聊天：列出所有聊天记录，可按活动或名称排序，支持过滤和分页。
4. 获取聊天详情：获取特定聊天的详细信息。
5. 获取消息上下文：检索特定消息前后的消息内容。
6. 发送消息：向指定联系人发送文本消息。

适用场景

1. 通过 AI 代理管理 WhatsApp 消息和联系人。
2. 自动化发送 WhatsApp 消息。
3. 检索和分析 WhatsApp 聊天历史。

工具列表

1. search_contacts：搜索联系人。
2. list_messages：列出消息历史。
3. list_chats：列出聊天记录。
4. get_chat：获取聊天详情。
5. get_message_context：获取消息上下文。
6. send_message：发送消息。

常见问题解答

1. QR 码问题：如果 QR 码未自动打开，手动打开控制台输出的 URL。
2. 认证失败：删除 ./auth_info/ 目录并重新启动服务器。
3. 消息同步问题：初始同步可能需要较长时间，检查 wa-logs.txt 文件。
4. MCP 连接问题：检查配置文件中的路径是否正确。

使用教程

使用依赖

1. Node.js：版本 23.10.0 或更高。
2. npm：通常随 Node.js 一起安装。
3. AI 客户端：如 Anthropic Claude Desktop 或 Cursor。

安装教程

1. 克隆仓库： bash git clone <your-repo-url> whatsapp-mcp-ts cd whatsapp-mcp-ts
2. 安装依赖： bash npm install
3. 运行服务器： bash node src/main.ts

调试方式

1. 检查日志：查看 wa-logs.txt 和 mcp-logs.txt 文件。
2. 验证路径：确保配置文件中的路径正确。
3. 重启服务：关闭并重新启动服务器以解决连接问题。

许可证

该项目遵循 ISC 开源许可条款。