Androidmcpserver

🚀 ADB MCP サーバー

このサーバーは、Android デバッグブリッジ (ADB) 用の MCP サーバーで、Claude が Android デバイスと相互作用できるようにします。

📚 技術記事

• 0 から 1 への Android MCP サービスの開発：MCP プロトコルと ADB の統合を理解する

✨ ツールリスト

1. get-devices

   • 接続されている Android デバイスをリスト表示します。
   • パラメータ：なし
   • 出力例：

   List of devices attached
   0a00000000000000	デバイス名	model	number
   

2. install-apk

   • デバイスに APK ファイルをインストールします。
   • パラメータ：<apk-path>
   • 例：

   install-apk /path/to/app.apk
   

3. uninstall-apk

   • デバイスからアプリケーションをアンインストールします。
   • パラメータ：<package-name>
   • 例：

   uninstall-apk com.example.app
   

4. start-activity

   • 指定された Activity を起動します。
   • パラメータ：<package-name>/<action> [--ez <name> <value>]
   • 例：

   start-activity com.example/.MainActivity --ez test 123
   

5. input-text

   • デバイスにテキストを入力します。
   • パラメータ：<text>
   • 例：

   input-text Hello, World!
   

6. click

   • デバイス上でのクリック操作をシミュレートします。
   • パラメータ：<x> <y>
   • 例：

   click 500 1200
   

7. screenshot

   • デバイスの画面をキャプチャします。
   • パラメータ：なし
   • 例：

   screenshot /path/to/screenshot.png
   

8. logcat

   • デバイスのログ情報を取得します。
   • パラメータ：[--pid <PID>] [--time]
   • 例：

   logcat --pid 1234
   

📦 インストール

サーバーのインストール手順

# リポジトリをクローンする
git clone [repository-url]
cd mcp-server-adb

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

Claude Desktop での設定

claude_desktop_config.json ファイルを編集し、以下の内容を追加します。

{
  "mcpServers": {
    "adb": {
      "command": "node",
      "args": ["-y", "/path/to/mcp-server-adb/build/index.js", "/path/to/adb"]
    }
  }
}

/path/to/adb を実際の ADB 実行ファイルのパスに置き換えてください。

Windsurf での設定

1. Node.js と ADB がインストールされていることを確認します。
2. プロジェクトをクローンしてビルドします。

git clone https://github.com/jiantao88/android-mcp-server.git
cd android-mcp-server
npm install
npm run build

3. Windsurf の設定に MCP 設定を追加します。

{
  "mcpServers": {
    "adb": {
      "command": "node",
      "args": [
        "/path/to/android-mcp-server/build/index.js",
        "/usr/local/bin/adb"
      ]
    }
  }
}

注意：

• すべてのパスを実際のパスに置き換えてください。
• /usr/local/bin/adb は ADB のデフォルトのインストール場所です。実際の状況に合わせて調整してください。

4. 設定を適用するために Windsurf を再起動します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。