WhatsApp MCP Server

基本能力

产品定位

WhatsApp MCP Server 是一个用于自动化 WhatsApp 桌面应用交互的工具，特别适用于需要通过程序化方式发送消息或检查应用状态的场景。

核心功能

1. 发送消息给联系人：
2. 通过连接的 WhatsApp 桌面应用发送文本消息
3. 支持包括换行在内的消息格式化

4. 使用 AppleScript 自动化 WhatsApp 桌面界面

5. 检查 WhatsApp 状态：

6. 返回 WhatsApp 应用的当前运行状态

7. 帮助防止在尝试发送消息时出现错误

8. 列出最近联系人：

9. 提供关于 WhatsApp 隐私限制的信息
10. 需要确切的联系人名称进行消息发送

适用场景

• 自动化发送 WhatsApp 消息
• 检查 WhatsApp 应用是否运行
• 与 Claude 等 AI 工具集成实现自然语言控制

工具列表

1. send-whatsapp-message：向指定 WhatsApp 联系人发送消息

2. 参数：contactName（联系人全名），message（消息内容）

3. check-whatsapp-status：检查 WhatsApp 应用是否正在运行

4. 无需参数

5. list-recent-contacts：提供关于 WhatsApp 联系人列表隐私限制的信息

6. 无需参数

常见问题解答

• 兼容性：仅适用于 macOS 系统
• 依赖：需要安装 WhatsApp 桌面应用和 Node.js v14.0.0 或更高版本
• 隐私限制：由于 WhatsApp 的隐私保护，联系人列表功能有限

使用教程

使用依赖

• macOS 操作系统
• WhatsApp 桌面应用
• Node.js v14.0.0 或更高版本

安装教程

# 克隆仓库
git clone https://github.com/yourusername/whatsapp-mcp-server.git

# 进入项目目录
cd whatsapp-mcp-server

# 安装依赖
npm install

启动服务器

node index.js

调试方式

• 检查控制台错误输出
• 查看日志文件：~/Library/Logs/whatsapp-mcp/
• 验证 AppleScript 执行是否成功

许可证

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