MCP Mobile Server

🚀 MCPモバイルサーバー

🌟 なぜMCPモバイルサーバーなのか？

MCPモバイルサーバーは、あなたのAIアシスタントをモバイル開発の強力なツールに変えます。Flutterでの開発、iOSアプリの作成、Androidアプリの開発など、どのようなモバイル開発にも対応しています。このサーバーは、Claude Desktop、Windsurf、その他のMCP互換クライアントとシームレスに統合されます。

✨ 主な機能

🚀 クイックスタート

インストール

# グローバルにインストール
npm install -g @cristianoaredes/mcp-mobile-server

# またはnpxで直接実行
npx @cristianoaredes/mcp-mobile-server

Claude Desktopとの統合

Claude Desktopの設定ファイル (~/Library/Application Support/Claude/claude_desktop_config.json) に以下を追加します。

{
  "mcpServers": {
    "mobile-dev": {
      "command": "npx",
      "args": ["@cristianoaredes/mcp-mobile-server"]
    }
  }
}

最初のステップ

# 環境を確認する
mcp-mobile-server health_check

# Flutterを自動でセットアップする
mcp-mobile-server flutter_setup_environment --action=full

# 開発を開始する
mcp-mobile-server flutter_dev_session --cwd=/path/to/project

🛠️ 利用可能なツール

🚀 スーパーツール - 完全なワークフロー

これらのインテリジェントなツールは、複数の操作を組み合わせて最大限の生産性を実現します。

💻 使用例

例1: Flutterプロジェクトを開始する

// Claude Desktopの会話
ユーザー: "新しいFlutterアプリを作成して実行してください"
Claude: 新しいFlutterアプリを作成し、開発サーバーを起動します。

// 内部的に実行されるコード:
flutter_create({ name: "my_app", org: "com.example" })
flutter_dev_session({ cwd: "./my_app", preferPhysical: true })

例2: ビルドエラーを修正する

// 自動エラー解決
ユーザー: "私のFlutterアプリがビルドできません"
Claude: ビルド問題を診断して修正します。

// 実行されるコード:
flutter_fix_common_issues({ cwd: ".", deep: true })

例3: 複数のプラットフォームにデプロイする

// 1コマンドでのデプロイ
ユーザー: "AndroidとiOS用のリリースバージョンをビルドしてください"
Claude: 両方のプラットフォーム用の最適化されたリリースビルドを作成します。

// 実行されるコード:
flutter_release_build({ 
  cwd: ".",
  platforms: ["apk", "appbundle", "ipa"],
  obfuscate: true
})

🏗️ アーキテクチャ

graph TD
    A[Claude Desktop / MCP Client] -->|JSON-RPC| B[MCP Mobile Server]
    B --> C[Tool Registry]
    B --> D[Process Manager]
    B --> E[Security Layer]
    
    C --> F[Flutter Tools]
    C --> G[Android Tools]
    C --> H[iOS Tools]
    C --> I[Super Tools]
    
    F --> J[Flutter SDK]
    G --> K[Android SDK]
    H --> L[Xcode]

設計原則

• 🔒 セキュリティ第一: すべてのコマンドは検証され、サンドボックス化されます。
• ⚡ パフォーマンス: 並列実行とインテリジェントなキャッシュを使用します。
• 🎯 信頼性: 自動リトライとフォールバック戦略を備えています。
• 📦 モジュール性: 拡張可能なプラグインアーキテクチャです。
• 🌍 クロスプラットフォーム: macOS、Linux、Windowsで動作します。

📋 要件

最低要件

• Node.js 18.0以上
• npm または yarn
• Flutter、Android SDK、またはXcodeのいずれか

推奨設定

• Flutter開発には Flutter 3.0以上
• Android開発には Android Studio または Android SDK
• iOS開発 (macOSのみ) には Xcode 14以上
• Flutter拡張機能付きの VS Code

🤝 コントリビュート

コントリビューションを歓迎します！詳細は コントリビュートガイド を参照してください。

開発環境のセットアップ

# リポジトリをクローンする
git clone https://github.com/cristianoaredes/mcp-mobile-server.git

# 依存関係をインストールする
cd mcp-mobile-server
npm install

# 開発モードで実行する
npm run dev

# テストを実行する
npm test

📚 ドキュメント

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

# セットアップツールを実行する
mcp-mobile-server flutter_setup_environment --action=full

# Android環境を設定する
mcp-mobile-server android_sdk_setup --action=configure

# 権限を確認する
ls -la $(which mcp-mobile-server)
chmod +x $(which mcp-mobile-server)

📊 プロジェクトの状態

📄 ライセンス

MITライセンス - 詳細は LICENSE を参照してください。

🙏 謝辞

• Model Context Protocol by Anthropic
• 素晴らしいフレームワークを提供している Flutter チーム
• このプロジェクトのすべてのコントリビューターとユーザー