使用说明
克劳德whatsapp mcp
克劳德代码的WhatsApp MCP服务器。阅读消息、发送回复、搜索联系人——所有这些都可以在您的终端上完成。
建于 whatsapp-web.js 和那个 模型上下文协议.
它做什么
让Claude Code直接访问您的WhatsApp：
- 阅读聊天记录 --“检查我的未读邮件”，“阿里说了什么？”
- 发送消息 --“向John发送提案PDF”
- 搜索联系人 --“找到莎拉的电话号码”
- 连接管理 --二维码认证，会话持久化
设置
1.克隆并安装
git clone https://github.com/ferazfhansurie/claude-whatsapp-mcp.git
cd claude-whatsapp-mcp
npm install
2.添加到克劳德代码
将此添加到您的Claude Code MCP设置中(~/.claude.json 或项目 .mcp.json):
{
"mcpServers": {
"whatsapp": {
"command": "node",
"args": ["/path/to/claude-whatsapp-mcp/src/index.js"]
}
}
}
3.连接WhatsApp
在Claude Code中，只需说：
connect to whatsapp
Claude将初始化服务器并向您显示二维码。用手机扫描（WhatsApp>设置>链接设备>链接设备）。
您的会话将继续 .wwebjs_auth/ --你只需要扫描一次。
工具
| 工具 | 说明 |
|---|---|
whatsapp_connect |
连接到WhatsApp或查看状态。如果需要，显示二维码。 |
whatsapp_send_message |
发送文本+可选文件附件 |
whatsapp_list_chats |
列出最近的未读聊天记录 |
whatsapp_read_chat |
读取特定聊天中的消息 |
whatsapp_search_contacts |
按姓名或号码搜索联系人 |
whatsapp_status |
连接状态+未读摘要 |
用法示例
# Check unreads
"do I have any unread WhatsApp messages?"
# Read a specific chat
"what's the latest in my family group?"
# Send a message
"send Ali a message saying the meeting is at 3pm"
# Send a file
"send the invoice PDF to +60123456789"
# Search contacts
"find contacts named Sarah"
需求
- Node.js 18+
- 支持MCP的Claude代码
- WhatsApp帐户
运作原理
服务器正在运行 whatsapp-web.js 在您的机器上本地安装——与WhatsApp Web相同的技术。您的消息将保留在设备上。不会向任何外部服务器发送任何内容。
第一次运行时，它会生成一个用于链接的二维码。之后，会话将被缓存并自动重新连接。
许可证
麻省理工学院
由...建造 广告代理