MCP Mobile Server

🚀 MCP移動服務器

MCP移動服務器藉助36個強大的工具和10個智能超級工具，為移動開發提供跨平臺支持，能將你的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

✨ 主要特性

智能自動化

• 智能設備選擇和管理
• 自動化環境設置
• 自修復構建流程
• 智能錯誤解決

開發者生產力提升

• 熱重載開發會話
• 一鍵部署
• 跨設備並行測試
• 自動化依賴管理

完整工具鏈

• Flutter、Android和iOS工具
• 模擬器控制
• 構建和測試自動化
• 性能分析

AI優先設計

• 為Claude Desktop構建
• 自然語言命令
• 上下文感知建議
• 工作流程優化

📦 安裝指南

全局安裝

npm install -g @cristianoaredes/mcp-mobile-server

使用npx直接運行

npx @cristianoaredes/mcp-mobile-server

💻 使用示例

基礎用法

啟動Flutter項目

// Claude Desktop對話
用戶: "創建一個新的Flutter應用並運行它"
Claude: 我將創建一個新的Flutter應用並啟動開發服務器。

// 幕後操作:
flutter_create({ name: "my_app", org: "com.example" })
flutter_dev_session({ cwd: "./my_app", preferPhysical: true })

高級用法

修復構建錯誤

// 自動錯誤解決
用戶: "我的Flutter應用無法構建"
Claude: 讓我診斷並修復構建問題。

// 執行:
flutter_fix_common_issues({ cwd: ".", deep: true })

多平臺部署

// 一鍵部署
用戶: "為Android和iOS構建發佈版本"
Claude: 我將為兩個平臺創建優化的發佈版本。

// 運行:
flutter_release_build({ 
  cwd: ".",
  platforms: ["apk", "appbundle", "ipa"],
  obfuscate: true
})

📚 詳細文檔

🔧 技術細節

架構

graph TD
    A[Claude Desktop / MCP客戶端] -->|JSON-RPC| B[MCP移動服務器]
    B --> C[工具註冊表]
    B --> D[進程管理器]
    B --> E[安全層]
    
    C --> F[Flutter工具]
    C --> G[Android工具]
    C --> H[iOS工具]
    C --> I[超級工具]
    
    F --> J[Flutter SDK]
    G --> K[Android SDK]
    H --> L[Xcode]

設計原則

• 🔒 安全第一：所有命令經過驗證並在沙盒中運行
• ⚡ 高性能：並行執行和智能緩存
• 🎯 可靠性：自動重試和回退策略
• 📦 模塊化：可擴展的插件架構
• 🌍 跨平臺：支持macOS、Linux和Windows

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE。

🙏 致謝

• 模型上下文協議 由Anthropic提供
• Flutter 團隊提供了出色的框架
• 本項目的所有貢獻者和用戶

🌟 支持項目

如果您覺得這個項目有用，請考慮：

為移動開發社區用心打造 ❤️

報告問題 • 請求新特性 • 文檔