Wechat Mcp

💬 Windows微信自动化消息助手

基于Windows桌面自动化实现微信消息监控与发送的MCP工具,通过模拟鼠标键盘操作控制微信客户端,支持截图、联系人搜索和消息发送功能。

收藏
10.4k
安装
2.8k
版本
1.0.0
CLS 安全性认证2026-05-07
点击查看完整报告 >

使用说明

核心用法

WeChat MCP 是一个基于 Windows 桌面自动化技术的微信客户端控制工具,采用 MCP(Model Context Protocol) 协议对外提供服务。其核心原理是通过 pyautoguipygetwindow 等库模拟人工操作:截取微信窗口截图、搜索联系人、激活聊天窗口、模拟键盘输入发送消息。

主要功能模块:

  • send_message_to_contact():完整流程自动化(搜索→打开→发送)
  • send_message_to_current():向当前已打开的聊天窗口快速发送
  • get_wechat_status():获取微信窗口的位置、大小、运行状态

集成方式:
作为 MCP Server 运行时,暴露 wechat_get_statuswechat_send_message 两个标准工具接口,供 Claude 等 AI 客户端调用。

显著优点

1. 零侵入性:无需修改微信客户端、无需 Hook 或逆向,纯模拟人工操作
2. 协议标准化:遵循 MCP 协议,可与主流 AI 助手无缝集成

3. 双模式支持:既支持完整联系人搜索流程,也支持当前窗口快速发送

4. 独立窗口兼容:可识别并操作微信的独立聊天窗口("Dragon" 窗口)

潜在缺点与局限性

| 维度 | 风险描述 |
|------|---------|
| **平台锁定** | 仅支持 Windows 系统,且需保持微信桌面客户端运行 |
| **UI 脆弱性** | 高度依赖微信界面布局,微信更新可能导致定位失效 |
| **输入法依赖** | 中文消息发送依赖系统中文输入法正常工作 |
| **性能瓶颈** | 模拟操作有延迟,高频发送可能触发微信风控 |
| **无消息接收** | 仅能发送和截图,无法结构化接收/解析消息内容 |

适合人群

  • 个人自动化用户:需要将 AI 助手与微信打通的 Windows 用户
  • 轻量级通知场景:服务器告警、定时提醒等低频单向推送需求
  • MCP 生态探索者:希望实践 MCP 协议与桌面自动化结合的案例学习

常规风险

  • 账号安全风险:自动化操作可能被微信识别为异常行为,导致功能限制或封号
  • 隐私泄露风险:截图功能可能捕获敏感聊天内容
  • 消息误发风险:坐标偏移或界面变化可能导致消息发送给错误的联系人
  • 依赖维护风险:OpenCV、Pillow 等依赖的版本兼容性需要持续关注

安全解读

核心用法

WeChat MCP 是一款基于 Python GUI 自动化技术的 Windows 微信消息发送工具,通过 MCP 协议与 LLM 集成。核心功能包括:搜索并打开指定联系人聊天窗口、向当前或指定聊天窗口发送文本消息、截取微信窗口截图获取状态、识别独立聊天窗口。

使用流程依赖 pyautogui 模拟人工操作:激活微信窗口 → 搜索联系人 → 点击进入聊天 → 通过剪贴板粘贴发送消息。提供 send_message_to_contact() 完整流程和 send_message_to_current() 当前窗口快捷发送两种模式。

显著优点

  • 零 API 依赖:不调用微信任何官方/私有接口,纯 GUI 模拟,规避封号风险
  • MCP 原生支持:标准化工具协议,可与 Claude、Cursor 等 AI 助手无缝集成
  • 独立窗口兼容:支持识别单独打开的微信聊天窗口(Dragon 窗口)
  • 本地隐私:无外部网络请求,数据不离开本机
  • 轻量易部署:仅 6 个常见 Python 依赖,5 个文件 254 行代码

潜在缺点与局限

稳定性脆弱:依赖微信窗口固定标题和坐标,微信更新 UI 或窗口缩放可能导致定位失败;多显示器、高分屏、缩放比例变化均可能破坏自动化。

体验干扰:运行时会强制激活微信窗口、抢占鼠标键盘控制权,用户无法并行操作;pyautogui.FAILSAFE = False 禁用安全退出,异常时可能失控。

隐私盲区:未告知用户即覆盖系统剪贴板、对微信窗口截图留存本地,敏感聊天内容存在泄露风险;缺乏截图自动清理机制。

功能单薄:仅支持纯文本消息,无法处理图片、文件、表情、@群成员;无发送成功回执校验,失败无重试;不支持多微信账号切换。

平台锁定:仅限 Windows,macOS/ Linux 不兼容。

适合人群

  • 需要让 AI 助手自动发送微信通知的开发者/极客用户
  • 本地定时任务(如服务器报警推送到个人微信)的运维场景
  • 能接受 GUI 自动化不稳定性、愿意自行调试窗口坐标的技术用户
  • 对微信封号极度敏感、宁可牺牲稳定性也不调用 API 的保守用户

不适合:追求高可靠性的生产环境、多账号运营、需要富媒体消息、对隐私合规有严格要求的商业场景。

常规风险

1. 误操作风险:窗口识别错误可能导致消息发错联系人,或点击到危险按钮(如删除、拉黑)
2. 剪贴板污染:覆盖用户正在使用的剪贴板内容,可能导致数据丢失

3. 截图残留:临时截图文件若未清理,敏感信息留存磁盘

4. 微信风控:高频自动化操作可能触发微信异常检测,导致功能限制或封号(虽无 API 调用,但行为模式异常)

5. 供应链风险:依赖包虽知名,但 pyautogui 等库本身具有强大系统操控能力,被恶意篡改后危害极大

Wechat Mcp 内容

手动下载zip · 4.1 kB
requirements.txttext/plain
请选择文件