Mobilerun

MCP サーバー

Mobilerun MCP サーバーを使って、AI エージェントから Android デバイスを操作できます。
任意の MCP クライアントから Mobilerun Cloud 上のデバイスを操作し、エージェントタスクを実行し、アプリを管理して、ワークフローを構築できます。

🔐 ホスト型 MCP エンドポイント — OAuth でサインイン。API キーは不要です

https://cloud.mobilerun.ai/api/mcp

• 📱 Android デバイスの一覧表示、作成、管理
• 📸 スクリーンショットと UI の状態を確認し、タップ、スワイプ、文字入力を実行
• 🤖 エージェントタスクを実行し、Mobilerun Assistant とチャット
• 📦 アプリ、デバイス上のファイル、設定を管理
• 🔀 アクション、トリガー、Webhook を使ったワークフローを構築
• 🔑 OAuth でサインイン — コピーする API キーは不要。ホスト型エンドポイントではインストールも不要です
• 🛠️ オープンソースで、セルフホスト可能です

🚀 クイックスタート

https://cloud.mobilerun.ai/api/mcp に接続します。初回接続時に、Mobilerun アカウントを使ったブラウザーでのサインインが開始されます（動的クライアント登録を使用した OAuth 2.1 + PKCE）。API キーは不要です。

Claude Code

claude mcp add --transport http mobilerun https://cloud.mobilerun.ai/api/mcp

Claude Code 内で /mcp を実行してサインインします。

Codex CLI

codex mcp add mobilerun --url https://cloud.mobilerun.ai/api/mcp
codex mcp login mobilerun

Cursor / VS Code

上のインストールバッジをクリックし、表示されたらサインインします。Cursor を手動で設定する場合は、下のその他の MCP クライアントにある mcpServers JSON を使用します。

{
  "servers": {
    "mobilerun": {
      "type": "http",
      "url": "https://cloud.mobilerun.ai/api/mcp"
    }
  }
}

Claude Desktop / claude.ai

この URL を使ってカスタムコネクターを追加し、サインインします。

https://cloud.mobilerun.ai/api/mcp

その他の MCP クライアント

クライアントの設定を使ってリモート HTTP サーバーを追加します。mcpServers を使用するクライアント（Cursor を含む）の場合：

{
  "mcpServers": {
    "mobilerun": {
      "url": "https://cloud.mobilerun.ai/api/mcp"
    }
  }
}

💬 試してみる

• 「Mobilerun のデバイスを一覧表示して。」
• 「デバイスで設定を開いて、ダークモードをオンにして。」
• 「デバイスのスクリーンショットを撮って、画面に表示されているものを説明して。」
• 「準備ができているデバイスを Mobilerun アシスタントに尋ねて。」

🧰 ツール

利用可能なツールと操作は、サーバーのポリシーとアカウントの権限によって異なります。

一部のツールは課金対象のリソースを作成します（例：create_device、プロキシの購入、またはアシスタントが代行する作業）。料金はサインイン中のアカウントに請求されます。アシスタントの権限を承認するのは、ユーザーが明示的に確認した後に限ってください。

🔑 API key（CI とヘッドレス）

OAuth を使用できないクライアントは、Authorization: Bearer dr_sk_... ヘッダーを付けて https://api.mobilerun.ai/v1/mcp に接続してください。Mobilerun Cloud でキーを作成してください。詳しくはAPI keysを参照してください。

{
  "mcpServers": {
    "mobilerun": {
      "url": "https://api.mobilerun.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer dr_sk_YOUR_KEY"
      }
    }
  }
}

claude mcp add --transport http mobilerun https://api.mobilerun.ai/v1/mcp --header "Authorization: Bearer dr_sk_YOUR_KEY"

🛠️ セルフホストと開発

packages/tools には認証方式に依存しないツールのコアが含まれています。packages/server は API キーを使用する HTTP および stdio トランスポートを提供します。 pnpm install && bun test を実行して開始してください。 セットアップ、設定、ポリシー、運用の詳細については、サーバーリファレンスを参照してください。 ロードマップではアーキテクチャを説明し、ツールコントラクトでは互換性とバージョン管理を扱っています。

🤝 貢献

開始するには、CONTRIBUTING.mdを参照してください。

🔒 セキュリティ

脆弱性はSECURITY.mdを使用して報告してください。

📄 ライセンス

Apache-2.0 のライセンスの下で提供されています。