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 团队提供了出色的框架
• 本项目的所有贡献者和用户

🌟 支持项目

如果您觉得这个项目有用，请考虑：

为移动开发社区用心打造 ❤️

报告问题 • 请求新特性 • 文档