Android Adb MCP Server

🚀 Android ADB MCP サーバー

Model Context Protocol (MCP) サーバーで、AI アシスタントが Android デバッグブリッジ（ADB）を介して Android デバイスとやり取りできるようになります。このサーバーは、AI 機能と Android デバイス管理を接続し、Android 開発とテスト操作のシームレスな自動化を実現します。

🚀 クイックスタート

⚙️ クイックセットアップ

サーバーを MCP 設定ファイルに追加します。

{
  "mcpServers": {
    "android-adb": {
      "command": "npx",
      "args": ["-y", "@landicefu/android-adb-mcp-server"],
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

設定場所

• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）
• Cline/Roo Code：~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json（macOS）
• Windows/Linux の場合は、該当するアプリケーションサポートディレクトリを確認してください。

設定を完了したら、AI アシスタントを再起動して新しいサーバー設定を読み込みます。

✨ 主な機能

📋 前提条件

• ADB (Android Debug Bridge) がインストールされ、システム PATH に追加されている必要があります。
  • Windows/Linux/Ubuntu での ADB のインストール
• クリップボードツール：
  • Windows：clip.exe
  • macOS：pbcopy
  • Linux：xclip または wl-copy
• Node.js (16.0+)

📸 利用可能なツール

🛠️ デバイス管理

• 自動デバイス選択：接続されているデバイスが 1 台の場合、自動的にそのデバイスが使用されます。
• デバイス ID 指定：-d <デバイスID> パラメータで特定のデバイスを指定できます。
• 複数デバイスサポート：複数のデバイスを同時に操作できます。

📄 スクリーンショットパスの解析

• 絶対パス：/path/to/screen.png
• 相対パス：./screen.png
• チルダで始まるパス：~/screen.png

🔧 トラブルシューティング

一般的な問題

1. デバイスが接続されていない
   • デバイスが USB で接続されていることを確認してください。
   • デバイスがデバッグを許可していることを確認してください。
2. ADB がインストールされていない
   • 前提条件を参照して ADB をインストールしてください。
3. 権限問題
   • 管理者権限でコマンドを実行してください。
4. ログが出力されない
   • デバイスが接続され、ログが出力されていることを確認してください。

解決策

1. デバイスが正しく接続されていることを確認します。

adb devices

2. ADB サービスを起動します。

adb start-server

📦 インストール

方法 1：npm を使用したインストール

npm install -g @landicefu/android-adb-mcp-server

方法 2：ソースコードからの手動インストール

1. リポジトリをクローンします。

git clone https://github.com/landicefu/android-adb-mcp-server.git
cd android-adb-mcp-server

2. 依存関係をインストールし、ビルドします。

npm install
npm run build

3. 直接パスを設定します。

{
  "mcpServers": {
    "android-adb": {
      "command": "node",
      "args": ["/path/to/android-adb-mcp-server/build/index.js"],
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

📄 ライセンス

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

🤝 コントリビューションガイド

コントリビューションを歓迎します！自由に Pull Request を送信してください。

1. リポジトリをフォークします。

git fork

2. 機能ブランチを作成します。

git checkout -b feature/amazing-feature

3. 変更をコミットします。

git commit -m 'Add some amazing feature'

4. ブランチにプッシュします。

git push origin feature/amazing-feature

5. Pull Request を送信します。