星战科技xingzhan.cloud
返回市场
WhatsApp-WebJS-MCP-服务器

WhatsApp-WebJS-MCP-服务器

作者：OzlevyQ2 星标更新：2025-06-09
安装使用来源：spider==github.com

项目介绍

🚀 WhatsApp Web.js MCP Server

高级MCP服务器，实现完整的WhatsApp控制

<div align="center">

WhatsApp TypeScript Node.js MCP

🌟 使用Claude AI的最先进WhatsApp控制系统

从Claude直接完全控制WhatsApp：发送消息、管理聊天、联系人等

🎯 快速安装 • 📱 特性 • 🔧 设置 • 🚀 示例

</div>

🎯 这是什么？

这是一个高级的模型上下文协议（MCP）服务器，允许Claude AI完全控制你的WhatsApp：

✨ 关键特性：

  • 🔄 自动连接 - 检测现有会话或显示新的二维码
  • 🌐 高级二维码界面 - 美丽的网页界面自动打开
  • 📱 20个高级工具 实现对WhatsApp的完全控制
  • 🌍 全面多语言支持 - 支持希伯来语右对齐、双语消息
  • 💾 会话持久性 - 一次设置，永久有效
  • 🚀 简单到极致 - 三步安装

📱 系统能力

📬 消息与通信

  • ✉️ 文本消息 具有完整的Unicode支持
  • 🖼️ 媒体 - 图片、视频、音频、文档
  • 📝 媒体说明
  • 💬 回复消息 到特定的消息
  • 👤 提及（@提及）
  • 🔍 消息搜索 根据文本内容
  • ↗️ 消息转发 在聊天之间
  • 🗑️ 删除消息 （为你或所有人）

💬 高级聊天管理

  • 📋 聊天列表（私人/群组/全部）
  • ℹ️ 详细聊天信息
  • 📦 归档/取消归档 聊天
  • 📌 钉住/取消钉住 重要聊天
  • 🔇 静音/取消静音 自定义时长
  • ✅ 标记已读/未读
  • 🧹 清除消息 从聊天中
  • ❌ 删除聊天 完全

👥 联系人管理

  • 📞 完整的联系人列表
  • 🔍 搜索 根据姓名或号码
  • 👤 详细的联系人信息
  • 🚫 屏蔽/取消屏蔽 联系人
  • 📸 个人资料图片
  • 📄 关于/状态消息
  • 👥 共同群组

🛠️ 快速安装

系统需求：

  • Node.js 18+
  • npm
  • Chrome/Chromium（用于whatsapp-web.js）

📦 三步安装：

# 1. 克隆项目
git clone https://github.com/ozlevyq/whatsapp-webjs-mcp-server.git
cd whatsapp-webjs-mcp-server

# 2. 安装依赖
npm install

# 3. 启动 - 就这样！
npm start

完成！ 🎉 系统将自动执行以下操作：

  • ✅ 检查现有会话
  • 🌐 如果需要，打开浏览器中的二维码
  • 📱 连接到WhatsApp
  • 🚀 准备接收Claude命令

🔧 MCP配置

⚙️ 添加到Claude桌面：

Windows:

{
  "whatsapp": {
    "command": "node",
    "args": ["C:\\Users\\YourName\\path\\to\\whatsapp-webjs-mcp-server\\dist\\index.js"]
  }
}

Mac:

{
  "whatsapp": {
    2"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"]
  }
}

📍 配置文件位置：

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Mac:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

🚀 使用示例

📱 发送消息：

发送给 972501234567@c.us: "你好！你好吗？"

📋 获取聊天列表：

给我看我的聊天列表

🔍 搜索联系人：

搜索名为“John”的联系人

📬 获取最近的消息：

获取“朋友”群组的最后10条消息

💬 管理聊天：

归档与John的聊天
钉住“工作”群组
将Mary的聊天静音24小时

🎨 高级二维码界面

<div align="center">

二维码界面

</div>

当需要连接时，系统：

  • 🌐 自动打开浏览器
  • 🎨 显示美观的多语言界面
  • 🔄 实时更新
  • ✅ 成功连接后通知

🌟 二维码界面特性：

  • 美观设计 - WhatsApp风格的绿色主题
  • 实时更新 - 每3秒自动刷新
  • 多语言 - 支持英语和希伯来语
  • 响应式 - 适用于桌面和移动设备
  • 自动清理 - 连接成功后二维码消失

🔧 故障排除

❓ 浏览器没有打开？

手动打开：http://localhost:3000

❓ “无效wid”错误？

使用格式：number@c.us（私人）或id@g.us（群组）

❓ 找不到聊天？

首先运行：whatsapp_get_chats 获取正确的ID

❓ 会话过期？

系统将自动显示新的二维码

❓ 连接超时？

确保WhatsApp Web在你的浏览器中正常工作

📋 可用工具

<details> <summary><strong>📬 消息工具（5）</strong></summary>
  1. whatsapp_send_message - 发送文本消息
  2. whatsapp_send_media - 发送图片、视频、文档
  3. whatsapp_get_messages - 获取聊天消息
  4. whatsapp_forward_message - 转发消息
  5. whatsapp_delete_message - 删除消息
</details> <details> <summary><strong>💬 聊天管理工具（8）</strong></summary>
  1. whatsapp_get_chats - 列出所有聊天
  2. whatsapp_get_chat_info - 获取聊天详情
  3. whatsapp_archive_chat - 归档/取消归档聊天
  4. whatsapp_pin_chat - 钉住/取消钉住聊天
  5. whatsapp_mute_chat - 静音/取消静音聊天
  6. whatsapp_mark_as_read - 标记为已读/未读
  7. whatsapp_clear_messages - 清除聊天消息
  8. whatsapp_delete_chat - 完全删除聊天
</details> <details> <summary><strong>👥 联系人管理工具（7）</strong></summary>
  1. whatsapp_get_contacts - 列出所有联系人
  2. whatsapp_get_contact_info - 获取联系人详情
  3. whatsapp_block_contact - 屏蔽/取消屏蔽联系人
  4. whatsapp_get_profile_picture - 获取个人资料图片
  5. whatsapp_get_contact_about - 获取关于/状态
  6. whatsapp_get_common_groups - 获取共享群组
  7. whatsapp_search_contacts - 搜索联系人
</details>

🚧 开发状态

  • ✅ 稳定发布 - 工作良好
  • 🔄 持续开发 - 定期改进
  • 🆘 全面支持 - 提供帮助
  • 🌟 功能请求 - 欢迎提出

🛣️ 计划：

  • 群组管理工具
  • 商业账户功能
  • 消息调度
  • 批量操作
  • 分析和报告

🤝 支持与联系方式

<div align="center">

开发者： Oz Levy

📧 邮箱： ozlevy@yadbarzel.info
📱 电话： +972-53-279-2278

GitHub Email

</div>

💬 获取帮助：

  • 🐛 错误报告 - 打开一个issue
  • 💡 功能请求 - 开始一个讨论
  • ❓ 问题 - 查看现有issues或提问
  • 🤝 贡献 - 欢迎pull requests

📜 许可证

MIT许可证 - 免费使用、分享和修改！🎉

版权所有 (c) 2024 Oz Levy

在此授权任何人免费获得此软件及其相关文档文件（以下简称“软件”），以无限制地处理软件，包括但不限于以下权利：
使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利，
以及向其提供软件的人进行上述操作的权利，但需遵守以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或实质部分中。

🌟 贡献

我们欢迎贡献！以下是步骤：

  1. Fork 仓库
  2. 创建 特性分支 (git checkout -b feature/amazing-feature)
  3. 提交 你的更改 (git commit -m '添加精彩特性')
  4. 推送 到分支 (git push origin feature/amazing-feature)
  5. 打开 Pull Request

🎯 贡献领域：

  • 🐛 错误修复
  • ✨ 新功能
  • 📚 文档改进
  • 🌍 翻译
  • 🎨 UI/UX增强
<div align="center">

🌟 喜欢这个项目吗？给它点赞！⭐

我们感谢反馈、建议和改进！

在以色列制作 ❤️ 🇮🇱

⚡ 准备用AI控制WhatsApp了吗？现在开始吧！

npm start
</div>