MCP Wechat Adb Server

🚀 MCP WeChat ADB Server

このプロジェクトは、ADBに基づく微信自動化MCPサーバーです。AIアシスタントに微信メッセージの送信とスクリーンショットの取得機能を提供し、AIが複数の連絡先に対して異なる個別化されたメッセージを自動的に返信することを可能にし、ビジネスや日常生活のニーズを満たします。レイデンエミュレーター（LDPlayer 9）に対応し、MCPプロトコルを通じてツールのインターフェースを公開します。藍耘MCP開発チャレンジの作品で、MCPのエントリーファイルはmain.pyです。

🚀 クイックスタート

✨ 主な機能

• 微信メッセージ送信：自然言語の指令で微信メッセージを送信できます。
• スマートスクリーンショット：自動的にスクリーンショットを撮り、ローカルに保存します。
• MCPプロトコルサポート：Cursor、Claude DesktopなどのMCPをサポートするAIアシスタントとシームレスに統合できます。
• レイデンエミュレーター対応：LDPlayer 9に特化して最適化されており、中国語入力にも対応しています。

📦 インストール

利用可能なツール

• send_wechat_message(name, message) - 微信メッセージを送信します。
• screen_save() - スクリーンショットを撮り、保存します。

環境要件

• Windows 10/11（テスト済み）
• Python >= 3.13
• レイデンエミュレーター LDPlayer 9（インストール済みで微信にログイン済み）
• ADBデバッグが有効になっていること（エミュレーターの診断情報でADBポートを確認できます）

完全なインストールと設定手順

ステップ1：レイデンエミュレーターのインストール

1. レイデンエミュレーターをダウンロードしてインストールします。テストでは9.1.58(64)の公式サイト最新バージョンを使用しています。インストールパスに空白を含めないでください。そして、パスをmain.pyのldplayer_dir変数に入力します。
2. エミュレーターの解像度を1600x900に設定します。
3. エミュレーター内で微信をインストールします。エミュレーター内で直接検索してインストールすればOKです。テストでは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変数に入力します。

ステップ2：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]"ライブラリをインストールするだけです。

ステップ3：設定と実行

1. エミュレーターのディレクトリ位置をmain.pyのldplayer_dir変数に入力します。
2. ステップ1で確認した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/ディレクトリに保存します。

ステップ4：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ファイル：ディレクトリ内のADBKeyboard.apkファイルは必須です。これはレイデンエミュレーターでADBを使用して中国語を入力するために必要なプラグインです。
• スクリーンショット機能：スクリーンショットはscreensフォルダに保存されます。
• ADBポートの確認：{エミュレーターのパス}\adb.exe devicesコマンドを使用して、使用可能なデバイスポートを確認します。

ディレクトリ構成

• main.py：MCPサービスのエントリーポイントで、ツールを登録してFastMCP（SSE伝送）を実行します。
• wechat_example.py：微信関連の操作（会話に入る、入力、送信など）をカプセル化します。
• adb_utils.py：ADBの基本機能（接続、クリック、入力法の有効化、スクリーンショット、解像度、Activityの検出など）を提供します。
• ADBKeyboard.apk：ブロードキャストでテキストを入力するために必要な入力法のAPKです（初回起動時に自動的にインストールされ、有効化されます）。
• screens/：スクリーンショットの出力ディレクトリです（自動的に作成されます）。

💻 使用例

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は微信の連絡先またはグループチャットの名前/メモに含まれる一意の名前でなければなりません。これにより、名前に基づいて正確に相手を見つけ、会話に入ることができます。

• 微信のメモを使用して、必要な人やグループチャットに特殊なメモを付けることで、検索が容易になります。

今後の計画

🚀 このプロジェクトでは、adb操作をMCPに完全に統合し、AIがエミュレーターを自由に操作できるようになりました。多モーダル大規模モデルの発展に伴い、将来的にはスクリーンショットを画像理解と位置特定能力を持つ大規模モデル（例：GLM - 4.5V）に入力し、AIエージェントが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/などの内容が配布パッケージに含まれないようにしています。