Mobile Dev MCP Server

🚀 モバイル開発 MCP

このプロジェクトは、AIによるモバイルデバイスの制御を可能にするModel Context Protocol（MCP）を提供します。MCPは、iOSとAndroidの開発環境に対応しており、アプリケーションのインストール、デバイスの管理、ログの取得などのタスクを支援するための便利なツールを提供します。

✨ 主な機能

• デバイス管理：接続されたすべてのデバイスとシミュレータを起動、停止、または一覧表示します。
• アプリケーション管理：デバイスにAPKをインストールし、インストール状態を確認します。
• ファイル管理：デバイス上のファイルをアップロード、ダウンロード、および管理します。
• スクリーンショットと診断：画面のスクリーンショットを取得し、基本的な診断を行います。
• ログ取得：デバイスのログ情報を取得し、問題のトラブルシューティングに役立てます。

📦 インストール

前提条件

このプロジェクトを使用する前に、以下のツールがインストールされていることを確認してください。

1. Android Debug Bridge (ADB)：Androidデバイスのデバッグと管理に使用します。
2. Xcode Command Line Tools：iOS開発用のコマンドラインツールです。
3. Facebook IDB ツール：デバイスまたはシミュレータとのインタラクションに使用します。

セットアップ手順

1. リポジトリをクローンする：

git clone https://github.com/jsuarezruiz/mobile-dev-mcp-server.git

2. プロジェクトディレクトリに移動する：

cd mobile-dev-mcp-server

3. .NET SDKを使用してプロジェクトをビルドする：

dotnet build

💻 使用例

基本的な使用法

MCPサービスを起動して機能をテストするには、以下のコマンドを実行します。

dotnet run

その後、MCP Inspectorツール（https://github.com/modelcontextprotocol/inspector）を使用してプロジェクトとやり取りできます。

高度な使用法

以下は、MCPと直接やり取りするためのサンプルクエリです。

1. APKをインストールし、状態を確認する：

"Install this APK on my device and confirm whether it was installed correctly."

2. デバイスのログを取得する：

"Provide a list of all applications installed on my phone."

3. ユーザー操作をシミュレートする：

"Press the Home button located at the coordinates (100, 1000)."

📚 ドキュメント

ツール一覧

以下は、一部の主要ツールの概要です。

• アプリケーションのインストール：install-apk
• アプリケーションの起動：launch-android-app
• ファイルの管理：manage-files
• スクリーンショットの取得：capture-screen
• ログの表示：view-logs

貢献ガイド

問題の修正、新機能の追加、またはドキュメントの改善など、どんな貢献も歓迎します！以下は、参加の流れです。

1. ブランチを作成する：

git checkout -b feature/my-feature

2. 変更をコミットする：

git commit -m 'Add a new feature'

3. ブランチをプッシュする：

git push origin feature/my-feature

4. プルリクエストを作成する

📄 ライセンス

このプロジェクトは、MIT Licenseのオープンソースライセンスの下で提供されています。