星战科技xingzhan.cloud
返回市场
移动服务器

移动服务器

作者：cristianoaredes3 星标更新：2025-11-18
安装使用来源：spider==github.com

项目介绍

🚀 MCP 移动服务器

<div align="center"> <img src="https://img.shields.io/badge/MCP-Mobile_Development-00D9FF?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxwYXRoIGQ9Im0xMiAzLTEuOSA3aDQuMnptMCAwdjE4bDggNS4yLTEyIDEuOXoiLz48L3N2Zz4=" alt="MCP 服务器"> <h3>使用AI驱动工具增强您的移动开发能力</h3> <p> <a href="https://www.npmjs.com/package/@cristianoaredes/mcp-mobile-server"><img src="https://img.shields.io/npm/v/@cristianoaredes/mcp-mobile-server.svg?style=flat-square&label=npm&color=CB3837" alt="NPM 版本"></a> <a href="https://github.com/cristianoaredes/mcp-mobile-server/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square" alt="许可证"></a> <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-1.0-green.svg?style=flat-square" alt="MCP 兼容性"></a> <img src="https://img.shields.io/badge/平台-Android%20|%20iOS%20|%20Flutter-orange.svg?style=flat-square" alt="平台"> <img src="https://img.shields.io/badge/工具-36-brightgreen.svg?style=flat-square" alt="工具"> </p> <p> <strong>36个强大的工具</strong>用于移动开发 • <strong>10个智能超级工具</strong> • <strong>跨平台支持</strong> </p> </div>

🌟 为什么选择 MCP 移动服务器？

MCP 移动服务器将您的AI助手转变为一个移动开发的强大引擎。无论您是使用 Flutter 开发，还是为 iOS 或 Android 创建应用，该服务器都能与 Claude Desktop、Windsurf 和其他 MCP 兼容客户端无缝集成。

✨ 关键特性

<table> <tr> <td width="50%">

🎯 智能自动化

  • 智能设备选择和管理
  • 自动环境设置
  • 自愈构建过程
  • 智能错误解决
</td> <td width="50%">

⚡ 开发者生产力

  • 热重载开发会话
  • 单命令部署
  • 设备间并行测试
  • 自动依赖管理
</td> </tr> <tr> <td width="50%">

🔧 完整工具链

  • Flutter、Android 和 iOS 工具
  • 模拟器和仿真器控制
  • 构建和测试自动化
  • 性能分析
</td> <td width="50%">

🤖 AI 首先设计

  • 专为 Claude Desktop 设计
  • 自然语言命令
  • 上下文感知建议
  • 工作流优化
</td> </tr> </table>

🚀 快速开始

安装

# 全局安装
npm install -g @cristianoaredes/mcp-mobile-server

# 或直接运行
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_dev_session完整的开发环境，带有热重载立即开始编码，自动选择最佳设备
flutter_test_suite运行所有测试并进行覆盖率分析CI/CD 流水线集成
flutter_release_build多平台发布构建通过单个命令部署到商店
mobile_device_manager智能设备编排自动启动最佳可用设备
flutter_fix_common_issues自动修复常见问题自动解决构建错误
<details> <summary><b>查看全部 36 个工具</b>（点击展开）</summary>

🔧 核心工具（5）

  • health_check - 系统诊断和环境验证
  • flutter_doctor - Flutter 环境验证
  • flutter_version - SDK 版本管理
  • flutter_list_devices - 设备发现
  • android_list_devices - Android 设备检测

📱 设备管理（9）

  • native_run_list_devices - 通用设备列表
  • native_run_install_app - 跨平台应用安装
  • ios_list_simulators - iOS 模拟器发现
  • android_list_emulators - AVD 管理
  • android_create_avd - 虚拟设备创建
  • android_start_emulator - 模拟器生命周期
  • android_stop_emulator - 资源管理
  • ios_shutdown_simulator - iOS 清理
  • flutter_launch_emulator - 快速模拟器启动

⚡ 开发（6）

  • flutter_run - 热重载服务器
  • flutter_build - 生产构建
  • flutter_test - 测试运行器
  • flutter_clean - 缓存管理
  • flutter_pub_get - 依赖项
  • android_install_apk - APK 部署

🛠️ 实用工具（4）

  • android_logcat - 调试日志
  • android_screenshot - 屏幕截图
  • ios_boot_simulator - iOS 启动
  • ios_take_screenshot - iOS 截图

🔧 设置工具（2）

  • flutter_setup_environment - 自动 Flutter 设置
  • android_sdk_setup - Android SDK 配置

🚀 高级工作流程（10）

  • flutter_performance_profile - 性能分析
  • flutter_deploy_pipeline - 完整部署
  • android_full_debug - 完整调试
  • ios_simulator_manager - iOS 编排
  • flutter_inspector_session - 小部件检查
</details>

💡 实际案例

示例 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：部署到多个平台

// 单命令部署
用户："为 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

📋 要求

最低要求

  • Node.js 18.0+
  • npm 或 yarn
  • 至少一种：Flutter、Android SDK 或 Xcode

推荐设置

  • Flutter 3.0+ 用于 Flutter 开发
  • Android Studio 或 Android SDK 用于 Android
  • Xcode 14+ 用于 iOS（仅限 macOS）
  • VS Code 带有 Flutter 扩展

🤝 贡献

我们欢迎贡献！详情请参阅我们的贡献指南。

开发设置

# 克隆仓库
git clone https://github.com/cristianoaredes/mcp-mobile-server.git

# 安装依赖
cd mcp-mobile-server
npm install

# 在开发模式下运行
npm run dev

# 运行测试
npm test

📚 文档

资源描述
📖 完整文档完整指南和 API 参考
🚀 快速入门指南五分钟内启动
🔧 故障排除常见问题及解决方案
🛠️ 工具参考工具详细文档
🏗️ 架构系统设计和内部结构

🐛 故障排除

<details> <summary><b>常见问题</b></summary>

Flutter 未找到

# 运行设置工具
mcp-mobile-server flutter_setup_environment --action=full

Android SDK 未配置

# 配置 Android 环境
mcp-mobile-server android_sdk_setup --action=configure

权限被拒绝错误

# 检查权限
ls -la $(which mcp-mobile-server)
chmod +x $(which mcp-mobile-server)
</details>

📊 项目状态

方面状态
版本2.1.0
稳定性测试版
工具36 个活跃
测试覆盖率78%
平台支持macOS ✅ Linux ✅ Windows ⚠️

📄 许可证

MIT 许可证 - 详情请参阅LICENSE。

🙏 致谢

<div align="center">

🌟 支持该项目

如果您觉得这很有用，请考虑：

GitHub Star Twitter Follow 买一杯咖啡

为移动开发社区打造，充满爱心

报告 Bug • 请求功能 • 文档

</div>