MCP Wechat Adb Server

🚀 MCP 微信 ADB 服務器

這是一個基於 ADB 的微信自動化 MCP 服務器，為 AI 助手提供微信消息發送和截圖功能。藉助它，AI 能夠自動向多個聯繫人發送不同的個性化微信消息，滿足商務與生活需求。本項目適配雷電模擬器（LDPlayer 9），並通過 MCP 協議對外暴露工具接口。此項目是藍耘 MCP 開發挑戰賽的作品，MCP 入口文件為 main.py。

🚀 快速開始

本服務器為 AI 助手賦予了微信消息發送和截圖的能力，可實現 AI 自動對多個聯繫人發送不同的個性化微信消息。以下是使用前的準備步驟。

✨ 主要特性

• 微信消息發送：支持通過自然語言指令發送微信消息。
• 智能截圖：可自動進行截圖並保存到本地。
• MCP 協議支持：能與 Cursor、Claude Desktop 等支持 MCP 的 AI 助手無縫集成。
• 雷電模擬器適配：專門為 LDPlayer 9 進行了優化，支持中文輸入。

📦 安裝指南

環境要求

• Windows 10/11（已測試）
• Python >= 3.13
• 雷電模擬器 LDPlayer 9（已安裝並登錄微信）
• 已啟用 ADB 調試（在模擬器 診斷信息 中可查看 ADB 端口）

完整安裝配置流程

第一步：安裝雷電模擬器

1. 下載並安裝雷電模擬器，測試使用的是 9.1.58(64) 官網最新版本。注意安裝路徑中不要有空格，並將路徑填入 main.py 的 ldplayer_dir 變量中。
2. 設置模擬器分辨率為 1600x900。
3. 在模擬器中安裝微信，可直接在模擬器裡搜索安裝，測試用的是 Version 8.0.58。
4. 登錄微信賬號並手動設置好權限。
5. 打開微信試用一下，確保不會彈出風險提示，能正常運行（一般微信都沒問題）。
6. 查看 ADB 端口：在命令行中執行以下命令查看可用的設備端口：

   D:\Program\leidian\LDPlayer9\adb.exe devices
   

   查看結果示例：

   List of devices attached
   127.0.0.1:5555  device
   emulator-5554   device
   

   選擇第一個端口（如 127.0.0.1:5555）填入 main.py 的 DEVICE 變量。

第二步：創建 Python 環境

可以使用 conda 或者 uv 創建環境，推薦使用 Python 3.13：

# 使用 conda
conda create -n mcp-wechat python=3.13
conda activate mcp-wechat

# 或使用 uv
uv venv
uv pip install "mcp[cli]"

只需要安裝 pip install "mcp[cli]" 庫即可。

第三步：配置和運行

1. 將模擬器目錄位置填入 main.py 的 ldplayer_dir 變量。
2. 將第一步查看到的 ADB 設備端口填入 main.py 的 DEVICE 變量（如 "127.0.0.1:5555"）。
3. 默認啟用 SSE 模式運行，用當前環境下的 Python 運行 main.py：

   python main.py
   

運行後會啟動 MCP SSE 服務並註冊以下工具：

• send_wechat_message(name: str, message: str) -> str

  • 功能：給指定聯繫人發送消息。
  • 依賴：微信已登錄、ADB 輸入法已激活。

• screen_save() -> str

  • 功能：在模擬器上截圖並保存到 screens/ 目錄。

第四步：配置 Cursor MCP

1. 在 Cursor 中設置：Tools and Integrations → Add Custom MCP。
2. 在 mcp.json 文件中寫入：

   {
     "mcpServers": {
       "plus": {
         "url": "http://127.0.0.1:8000/sse"
       }
     }
   }
   

3. 開啟這個 MCP Tools，顯示小綠點以後即可正常在 Cursor 的 Agent 對話框裡對話。

重要注意事項

⚠️ 重要提示

• 目錄下的 ADBKeyboard.apk 文件不能少，這是雷電模擬器的 ADB 輸入中文需要的插件。
• 截圖功能會將截圖保存在 screens 文件夾下。
• 使用 {模擬器路徑}\adb.exe devices 命令查看可用的設備端口。

💻 使用示例

配置好 MCP 後，您可以在 Cursor 的 Agent 中直接使用以下功能：

基礎用法

發送微信消息

給 AAA 說我感冒了，寫一個請假條發給他

截圖功能

幫我截圖

高級用法

組合使用示例

給 AAA、 BBB 發信息說我今晚不回家，分別截圖

演示視頻：

https://github-production-user-asset-6210df.s3.amazonaws.com/22809627/477622786-0ec32420-ddcc-4d1e-9482-905de7c3cf8f.mp4

⚠️ 重要提示

AAA、BBB 需要是微信中聯繫人或群聊的名字/備註中能搜索到的唯一名稱，這樣才能根據名字準確找到指定對方並進入對話。可以使用微信備註 給需要的人和群聊特殊的備註，以便搜索。

📚 詳細文檔

目錄結構

• main.py：MCP 服務入口，註冊工具並運行 FastMCP（SSE 傳輸）。
• wechat_example.py：封裝，有微信相關操作（進入對話、輸入、發送等）。
• adb_utils.py：ADB 基礎能力（連接、點擊、輸入法激活、截圖、分辨率、Activity 檢測等）。
• ADBKeyboard.apk：通過廣播輸入文本所需的輸入法 APK（首次會自動安裝並激活）。
• screens/：截圖輸出目錄（自動創建）。

後續計劃

本項目已實現將 adb 操作完美接入 MCP，讓 AI 可以自由操作模擬器。隨著多模態大模型的發展進步，後續可以將截圖輸入給具有圖像理解和定位能力的大模型（例如 GLM - 4.5V），讓 AI Agent 通過 MCP 能完全自動化地邊看邊操作每一步，完成任何手機上的任務。

常見問題排查

💡 使用建議

路徑分隔符在 Windows 下建議使用原始字符串或雙反斜槓，例如：

ldplayer_install_dir = r"D:\\Program\\leidian\\LDPlayer9"

首次運行會自動檢查並安裝/激活 ADBKeyboard.apk，若自動激活失敗，可手動執行例如：

"D:\Program\leidian\LDPlayer9\adb.exe" -s 127.0.0.1:5555 install -r ADBKeyboard.apk
"D:\Program\leidian\LDPlayer9\adb.exe" -s 127.0.0.1:5555 shell ime enable com.android.adbkeyboard/.AdbIME
"D:\Program\leidian\LDPlayer9\adb.exe" -s 127.0.0.1:5555 shell ime set com.android.adbkeyboard/.AdbIME

• 連接失敗或超時：
  • 確認 adb.exe 路徑是否正確，能否執行：

    "D:\Program\leidian\LDPlayer9\adb.exe" devices  
    "D:\Program\leidian\LDPlayer9\adb.exe" connect 127.0.0.1:5555
    "D:\Program\leidian\LDPlayer9\adb.exe" -s 127.0.0.1:5555 shell screencap -p /sdcard/screen.png
    

  • 確認模擬器中 ADB 端口與 ld_adb_address 一致。
  • 確認模擬器中 ADB 端口與 DEVICE 變量一致。
  • 如果設備列表為空，請檢查模擬器是否正常運行，ADB 調試是否已啟用。

📄 許可證

本項目採用 MIT 許可證。

⚠️ 重要提示

• 本項目僅用於學習和研究目的。
• 使用本工具時請遵守相關法律法規和微信用戶協議。
• 請勿用於商業用途或惡意用途。
• pyproject.toml 已通過打包排除規則避免將 runtime/、screens/ 等內容發佈到分發包。