🚀 WhatsApp Web.js MCP服务器
高级MCP服务器，用于完全控制WhatsApp
🌟 采用Claude AI的最先进WhatsApp控制系统
*直接从Claude完成WhatsApp控制-发送消息、管理聊天、联系人等*
______________________________________________________________________
🎯 这是什么？
这是一个高级 模型上下文协议（MCP） 允许的服务器 克劳德 AI 要完全控制您的WhatsApp：
✨ 主要特点：
- 🔄 自动连接 -检测现有会话或显示新的二维码
- 🌐 高级QR界面 -漂亮的网页界面会自动打开
- 📱 20种高级工具 完全控制WhatsApp
- 🌍 全面的多语言支持 -希伯来语RTL，双语信息
- 💾 会话保持 -一次性设置，永久有效
- 🚀 越简单越好 -3-命令安装
______________________________________________________________________
📱 系统能力
📬 信息与通信
- ✉️ 文本消息 完全支持Unicode
- 🖼️ 媒体 -图像、视频、音频、文档
- 📝 媒体标题
- 💬 邮件回复 到特定消息
- 👤 提及（@提及）
- 🔍 邮件搜索 按文本内容
- ↗️ 消息转发 聊天之间
- 🗑️ 消息删除 （为你或所有人）
💬 高级聊天管理
- 📋 聊天列表 （私人/团体/所有）
- ℹ️ 详细聊天信息
- 📦 存档/无存档 聊天
- 📌 固定/取消固定 重要聊天
- 🔇 静音/取消静音 具有自定义持续时间
- ✅ 标记为已读/未读
- 🧹 清除信息 来自聊天
- ❌ 删除聊天 完全
👥 联系人管理
- 📞 完整联系人列表
- 🔍 搜索 按姓名或号码
- 👤 详细联系方式
- 🚫 阻止/解除阻止 联系人
- 📸 个人资料图片
- 📄 关于/状态消息
- 👥 公用组
______________________________________________________________________
🛠️ 快速安装
系统要求：
- Node.js 18+
- npm
- 铬/铬 （适用于whatsapp web.js）
📦 分3步安装：
# 1. Clone the project
git clone https://github.com/ozlevyq/whatsapp-webjs-mcp-server.git
cd whatsapp-webjs-mcp-server
# 2. Install dependencies
npm install
# 3. Start - That's it!
npm start完成！ 🎉 系统将自动执行所有操作：
- ✅ 检查现有会话
- 🌐 如有需要，使用二维码打开浏览器
- 📱 连接到WhatsApp
- 🚀 准备执行克劳德命令
______________________________________________________________________
🔧 MCP配置
⚙️ 添加到克劳德桌面：
窗户：
{
"whatsapp": {
"command": "node",
"args": ["C:\\Users\\YourName\\path\\to\\whatsapp-webjs-mcp-server\\dist\\index.js"]
}
}雨衣：
{
"whatsapp": {
"command": "node",
"args": ["/Users/YourName/path/to/whatsapp-webjs-mcp-server/dist/index.js"]
}
}Linux：
{
"whatsapp": {
"command": "node",
"args": ["/home/YourName/path/to/whatsapp-webjs-mcp-server/dist/index.js"]
}
}📍 配置文件位置：
窗户：
%APPDATA%\Claude\claude_desktop_config.json雨衣：
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux：
~/.config/Claude/claude_desktop_config.json______________________________________________________________________
🚀 使用示例
📱 发送消息：
Send to 972501234567@c.us: "Hello! How are you?"📋 获取聊天：
Show me my chat list🔍 搜索联系人：
Search for contact named "John"📬 获取最新消息：
Get the last 10 messages from the "Friends" group💬 管理聊天：
Archive the chat with John
Pin the "Work" group
Mute the chat with Mary for 24 hours______________________________________________________________________
🎨 高级QR界面
当需要连接时，系统：
- 🌐 自动打开浏览器
- 🎨 显示漂亮的多语言界面
- 🔄 实时更新
- ✅ 成功连接时通知
🌟 QR界面功能：
- 漂亮的设计 -WhatsApp风格的绿色主题
- 实时更新 -每3秒自动刷新一次
- 多语言 -英语和希伯来语支持
- 响应式 -适用于台式机和移动设备
- 自动清理 -连接后QR消失
______________________________________________________________________
🔧 故障排除
❓ 浏览器无法打开？
手动打开： http://localhost:3000
❓ “无效宽度”错误？
使用格式： number@c.us （私人）或 id@g.us （组）
❓ 找不到聊天记录？
先跑： whatsapp_get_chats 获取正确的ID
❓ 会话已过期？
系统将自动显示新的二维码
❓ 连接超时？
首先确保WhatsApp Web在您的浏览器中正常工作
______________________________________________________________________
📋 可用工具
📬 Messaging Tools (5)
- whatsapp_send_消息 -发送短信
- whatsapp_send_media -发送图像、视频、文档
- whatsapp_et_messages -检索聊天消息
- whatsapp_forward_消息 -转发邮件
- whatsapp_delete_message -删除邮件
💬 Chat Management Tools (8)
- whatsapp_getchats -列出所有聊天记录
- whatsapp_get_chat_info -获取聊天详细信息
- whatsapp_archive_chat -存档/未存档聊天
- whatsapp_in-chat -固定/取消固定聊天
- whatsapp_mute_chat -静音/取消静音聊天
- whatsapp_mark_as_read -标记为已读/未读
- whatsapp_1ear_消息 -清除聊天信息
- whatsapp_delete_chat -完全删除聊天
👥 Contact Management Tools (7)
- whatsapp_getcontacts -列出所有联系人
- whatsapp_getcontact_info -获取联系方式
- whatsapp_block_联系方式 -阻止/取消阻止联系人
- whatsapp_getprofile_picture -获取个人资料图片
- whatsapp_getcontact_about -了解/状态
- whatsapp_get_common_groups -获取共享组
- whatsapp_search_contacts -搜索联系人
______________________________________________________________________
🚧 开发状态
- ✅ 稳定版 -工作出色
- 🔄 持续发展 -定期改进
- 🆘 全力支持 -可提供帮助
- 🌟 功能请求 -欢迎光临
🛣️ Roadmap:
- \[\]组管理工具
- \[\]业务帐户功能
- \[\]消息调度
- \[\]批量操作
- \[\]分析和报告
______________________________________________________________________
🤝 支持与联系
开发人： 奥兹·利维
📧 电子邮件： ozlevy@yadbarzel.info\ 📱 电话： +972-53-279-2278
](https://github.com/yourusername) 
💬 获取帮助：
- 🐛 错误报告 -打开一个问题
- 💡 功能请求 -开始讨论
- ❓ 问题 -检查现有问题或提问
- 🤝 贡献 -欢迎拉取请求
______________________________________________________________________
📜 许可证
MIT许可证 -免费使用、分享和修改！ 🎉
Copyright (c) 2024 Oz Levy
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.______________________________________________________________________
🌟 贡献
我们欢迎捐款！方法如下：
- 分叉 存储库
- 创建 特征分支(
git checkout -b feature/amazing-feature) - 提交 您的更改(
git commit -m 'Add amazing feature') - 推 到分行(
git push origin feature/amazing-feature) - 打开 拉取请求
🎯 贡献领域：
- 🐛 错误修正
- ✨ 新功能
- 📚 文档改进
- 🌍 翻译
- 🎨 UI/UX增强功能
______________________________________________________________________
🌟 喜欢这个项目吗？给它一颗星！ ⭐
我们感谢您的反馈、建议和改进！
由以下材料制成❤️ 以色列🇮🇱
______________________________________________________________________
⚡ 准备好用人工智能控制WhatsApp了吗？现在开始！
npm start