wxauto-mcp

Windows 微信 MCP 服务，提供 UIA 探测和微信自动化工具，并通过单消费者队列串行执行。

能力

• 只读探测微信 UIA 可用性
• 加好友、检查或同意好友申请
• 发送消息、监听单个或多个会话、读取可见消息
• 上传媒体、发布朋友圈、读取最近朋友圈验证结果
• SQLite 任务记录、同类待执行任务去重、单 worker 串行操作微信
• Streamable HTTP、Bearer Token、真实动作双重确认

本项目只提供 MCP 服务，不包含 GUI、托盘、独立调用客户端、定时调度或大模型模块。

安装与启动

要求 Windows 10/11、Python 3.10+、已登录的微信 PC 端，以及未锁屏的交互式桌面。

python -m pip install -e .
python -m wxclient.mcp_server --allow-real-actions

默认端点是 http://127.0.0.1:8765/mcp。远程部署、安全配置、工具参数和扩展方式见 MCP 服务文档。

打包

python -m pip install -e ".[build]"
python scripts\build_mcp_onefile.py --dry-run
python scripts\build_mcp_onefile.py

产物为 dist\wxclient-mcp.exe。

保留的架构边界

wxclient/
  mcp_server/   # HTTP MCP、鉴权、工具注册、媒体上传
  queue/        # SQLite 任务与单消费者 worker
  wechat_api/   # pyweixin 二次封装
  uia_probe/    # 只读 UIA 状态探测
  config/       # Windows 微信运行参数

所有微信 UI 动作必须通过 mcp_server -> queue -> wechat_api，不能在 MCP 工具函数中 直接操作窗口。UIA 探测不会启动、关闭、重启或解锁微信。