Winautowx

🚀 WinAutoWx 針對 Weixin/WeChat 自動化腳本 支持 LLM 的 MCP

本項目藉助 Python + pywinauto 構建自動化腳本，可在 Windows 系統上連接或啟動微信（Weixin/WeChat）。能夠搜索好友或群聊併發送消息，還支持一次性向多個好友循環發送多條消息。

交流群

讚賞

🚀 快速開始

若需要通過命令行快速發送或調試，請查看 Debug.md。以下為通過 HTTP API/MCP 的方式：

✨ 主要特性

• 基於 Python + pywinauto 實現 Windows 上微信自動化操作。
• 可連接/啟動微信，搜索好友或群聊併發送消息。
• 支持一次性向多個好友循環發送多條消息。
• 提供 HTTP API 和 fastmcp（MCP/stdio）服務調用方式。

📦 安裝指南

環境要求

• Windows 10/11（64 位推薦）
• Python 3.8–3.12（64 位推薦）
• 已安裝並登錄 Windows 版微信（Weixin/WeChat）

安裝命令

pip install -r requirements.txt

💻 使用示例

通過 API 調用（FastAPI / fastmcp 2.0）

已提供 server.py，可作為本地服務供 AI/HTTP 調用。

啟動服務

uvicorn server:app --host 127.0.0.1 --port 8000

發送消息接口

POST http://127.0.0.1:8000/send

{
  "friends": ["文件傳輸助手"],
  "messages": ["測試一下"],
  "backend": "win32",
  "ctrl_enter": false,
  "friend_delay": 0.5,
  "message_delay": 0.2,
  "no_launch": false,
  "verbose": true
}

導出控件接口

POST http://127.0.0.1:8000/dump

{
  "backend": "win32",
  "verbose": true
}

說明：腳本主體位於 script/wechat_sender.py。命令行使用說明見 Debug.md；HTTP 接口由 server.py 提供。

通過 fastmcp（MCP/stdio 協議）

已提供 mcp_server.py（基於 fastmcp 2.0）。它是一個 MCP 服務器，通過標準輸入輸出（stdio）對外暴露工具。內部會把工具調用轉發到上面的 HTTP 服務。

步驟 1：安裝依賴並啟動 HTTP 服務

pip install -r requirements.txt
uvicorn server:app --host 127.0.0.1 --port 8000

步驟 2：啟動 MCP 服務器（stdio）

python mcp_server.py

步驟 3：用 MCP Inspector 連接（廢棄）

mcp-inspector --server "python mcp_server.py"

工具說明：

• send_messages(friends, messages, backend='uia'|'win32', ctrl_enter=False, friend_delay=0.5, message_delay=0.2, no_launch=False, verbose=False)
• dump_controls(backend='uia'|'win32', verbose=True)

可用環境變量：

• WEIXIN_API_URL：轉發的 HTTP 服務地址（默認 http://127.0.0.1:8000）

MCP Inspector 配置

步驟 1：啟動 HTTP 服務（新終端）

uvicorn server:app --host 127.0.0.1 --port 8000

npx @modelcontextprotocol/inspector

步驟 2：在 MCP Inspector 中填寫配置

• Server command：

python mcp_server.py

• Working Directory：

D:\代碼存儲\winautowx

• Environment variables（可選）：
  • WEIXIN_API_URL: http://127.0.0.1:8000
• Arguments：留空
• Transport：默認 stdio（保持不變）
• 點擊 Connect

步驟 3：在 Inspector 中調用 tools

• send_messages 示例參數：

{
  "friends": ["文件傳輸助手"],
  "messages": ["測試一下"],
  "backend": "win32",
  "ctrl_enter": false,
  "friend_delay": 0.5,
  "message_delay": 0.2,
  "no_launch": false,
  "verbose": true
}

• dump_controls 示例參數：

{
  "backend": "win32",
  "verbose": true
}

🔧 技術細節

啟動指令速查

• 命令行（CLI 用法已遷移至 Debug 文檔）：請參考 Debug.md 獲取 run_wechat.py 的命令行用法與調試說明。
• 啟動 HTTP API 服務（FastAPI）：

uvicorn server:app --host 127.0.0.1 --port 8000

• 啟動 fastmcp（MCP/stdio）服務並用 MCP Inspector 連接：

python mcp_server.py
mcp-inspector --server "python mcp_server.py"

參數說明（CLI）

命令行參數表已遷移至 Debug.md。

常見用法示例（CLI）

命令行示例已遷移至 Debug.md。

💡 使用建議

⚠️ 重要提示

此腳本僅用於學習與個人效率用途。請遵守相關平臺使用條款，避免濫用自動化操作。

💡 使用建議

• 保持微信主窗口處於當前桌面且未最小化。
• 先用“文件傳輸助手”驗證流程，避免打擾他人。
• 若你的微信版本為新版 Weixin（進程 Weixin.exe），腳本已適配。
• 特殊佈局或企業微信可能與控件結構不同，遇到問題請開 --verbose 並將輸出粘貼給開發者。