CodeDroid

ローカル

get.codedroid.com開発ツール1今日更新

リポジトリ公式サイト

CodeDroid について

CodeDroidは、コーディングエージェントなどのMCPクライアントからペアリング済みAndroid端末を操作するMCPサーバーです。画面確認、入力、アプリ操作、端末テストに対応し、端末とPCが別ネットワークでも利用できます。

主な機能

01画面の読み取りとスクリーンショット
02タップ、入力、スワイプ、アプリ起動
03複数手順の端末タスクの委任
04PCからのAPKインストール
05adbコマンドの実行とログ確認

活用シーン

01開発中のアプリ画面の確認
02端末でのサインイン手順のテスト
03ビルドのインストールとクラッシュ確認
04端末テストとログの確認

MCP 対応

MCPクライアントとペアリング済みAndroid端末の間で操作と画面情報を中継するツールを提供します。ローカルサーバーはCodeDroidサーバー経由で接続し、任意のadbツールはPC上でコマンドを実行します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "codedroid-team-codedroid": {
      "command": "npx",
      "args": [
        "-y",
        "@codedroid/mcp"
      ],
      "env": {
        "CODEDROID_MCP_ADB": "<CODEDROID_MCP_ADB>",
        "CODEDROID_SERIAL": "<CODEDROID_SERIAL>",
        "CODEDROID_MCP_CLIENT": "<CODEDROID_MCP_CLIENT>"
      }
    }
  }
}

起動コマンドnpx -y @codedroid/mcp

設定が必要な環境変数

CODEDROID_MCP_ADBSet to 0 to turn off the adb tool, which runs adb commands on this computer.

CODEDROID_SERIALadb serial of the phone to use when several devices are connected.

CODEDROID_MCP_CLIENTClient name shown on the phone while the agent uses it.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@codedroid/mcp0.1.9stdio

ツール

掲載時のツール一覧 · 今日に更新

このツールにパラメーターはありません。

詳細

CodeDroid MCP

Claude Code、Codex、Gemini CLI、または任意の MCP クライアントから Android スマートフォンを操作できます。画面を読み取り、アプリを操作し、スクリーンショットを撮影して、CodeDroid を通じて開発したものをテストできます。スマートフォンとコンピューターは、異なるネットワークに接続されていてもかまいません。

はじめに

Node.js 20+ と、アクセシビリティサービスを有効にしてサインインした Android スマートフォン上の CodeDroid が必要です。両方のデバイスでインターネットに接続できる必要があります。

1. コーディングクライアントにインストールする

すべてのクライアントに一括でインストール — ターミナルで実行します。

npx -y @codedroid/mcp setup

Claude Code、Codex、Gemini CLI、Cursor、VS Code、Claude Desktop、Windsurf を検出し、確認後にそれぞれに CodeDroid を追加します。アップデート後に再実行してください。すでに設定済みのクライアントはスキップされます。または、1 つのクライアントにインストールします。

Claude Code — Claude Code 内で実行します。

/plugin marketplace add codedroid-team/codedroid-mcp
/plugin install codedroid@codedroid

Codex — ターミナルで実行します。

codex plugin marketplace add codedroid-team/codedroid-mcp
codex plugin add codedroid@codedroid

Gemini CLI — ターミナルで実行します。

gemini extensions install https://github.com/codedroid-team/codedroid-mcp

各インストールには、MCP サーバーと、スマートフォンの操作および Android アプリのテスト用スキルが含まれます。インストール後、コーディングクライアントを再起動してください。

別のクライアントをお使いですか？ MCP の手動設定をご覧ください。

2. スマートフォンをペアリングする

スマートフォンで CodeDroid → Settings → Computers → Pair a computer を開きます。
表示されたコマンドを、コンピューターのターミナルで実行します。例：
```
npx -y @codedroid/mcp pair ABCD-EFGH
```
プロンプトが表示されたら、スマートフォンで Allow をタップします。

表示されたコマンドをそのまま使用してください。ペアリングコードの有効期限は 10 分間で、一度だけ使用できます。

3. エージェントに依頼する

スマートフォンの画面を読み取り、何が表示されているか説明してください。

次に、以下を試してみてください。

「Android の設定を開いて、Android のバージョンを確認してください。」
「自分のアプリを開き、サインイン画面に移動して、スクリーンショットを撮ってください。」
「この APK をインストールして起動し、クラッシュがないか確認してください。」*

*install_apk は CodeDroid の接続を通じて動作し、1 つの設定を有効にするだけで利用できます。adb でログを読み取るには、Android platform-tools と USB またはワイヤレスデバッグ接続も必要です。adb の設定をご覧ください。

含まれる機能

画面の読み取り、スクリーンショットの撮影、タップ、入力、スワイプ、アプリの起動、CodeDroid のエージェントへの複数ステップのタスクの依頼を行う MCP ツール。1 台または複数台のスマートフォンで利用できます。ツール一覧をご覧ください。
スキル：codedroid-phone は、確認を挟みながら一度に 1 ステップずつスマートフォンを操作する方法をエージェントに教えます。test-on-device は、Android アプリの変更をビルド、インストール、検証する手順を案内します。create-cujs は、アプリの重要なユーザージャーニーをリポジトリ内の Markdown ファイル（cujs/）に記述します。create-tests はそれらにテストケースを追加し、test-on-device はスマートフォン上でテストを実行します。
コンピューターからビルドをインストールする install_apk。ケーブルも、同じネットワークへの接続も必要ありません。
コンピューター上で adb コマンドを実行してログを読み取り、テストを実行する adb ツール。無効にすることもできます。

プライバシーとセキュリティ

このプラグインは npx -y @codedroid/mcp@<version> を実行し、npm から該当するバージョンをダウンロードして、ローカル MCP サーバーを起動します。送信されるすべてのデータは、TLS 経由で CodeDroid サーバー orchestrator.codedroid.com に送られます。ただし、スマートフォンに表示されるペアリングコマンドで別のサーバーが指定されている場合は除きます。

ペアリングでは、スマートフォンに接続中のコンピューターを表示できるように、ワンタイムコード、コンピューター名、OS（例：darwin）を送信します。
ツール呼び出しは、エージェントとスマートフォンの間で中継されます。対象には、画面の内容、スクリーンショット、入力を依頼したテキスト、クリップボードの読み取りと書き込み、タスクの進行状況が含まれます。各呼び出しには、呼び出し元の MCP クライアント名とバージョンも含まれます。初回はスマートフォンでコンピューターの Allow を求められ、使用中のコンピューターが表示されます。また、アクセスを停止または取り消すこともできます。

ローカルサーバーは 127.0.0.1 のみでリッスンし、ユーザーごとのトークンが必要です。ペアリング認証情報、トークン、ログは、コンピューターの ~/.codedroid に保存されます。adb ツールはコンピューター上でのみ実行され、その push と pull はプロジェクトディレクトリと一時ディレクトリ内で完結します。詳しくはアーキテクチャをご覧ください。

プラグイン自体はアナリティクスを収集しません。CodeDroid アプリとサーバーは、CodeDroid アカウントに使用記録を保存します。記録される内容は、ペアリングと接続、コンピューターへのアクセス許可の有無、各スマートフォンツール呼び出しの名前、成功したかどうかとエラーコード、所要時間、関係する MCP クライアント、セッションとバージョン、コンピューターの OS とそのランダム ID、run_task のタスク ID です。使用記録にツールの引数、画面の内容、入力したテキストが含まれることはありません。

ヘルプが必要ですか？

接続を確認してください。

npx -y @codedroid/mcp status

コンピューターへのアクセスは、CodeDroid → Settings → Computers で管理または取り消せます。

ツール、手動セットアップ、設定、トラブルシューティング、開発については、リファレンスガイドをご覧ください。

ライセンス

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

CodeDroid

CodeDroid について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

CodeDroid MCP

はじめに

1. コーディングクライアントにインストールする

2. スマートフォンをペアリングする

3. エージェントに依頼する

含まれる機能

プライバシーとセキュリティ

ヘルプが必要ですか？

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？