使用说明

MCP移动服务器——基于AI的Android、iOS和Flutter移动开发

36个移动开发自动化工具，可在Claude Desktop和任何兼容MCP的AI客户端中使用。

这是什么？

MCP移动服务器是模型上下文协议服务器，让AI助手直接、结构化地访问您的移动开发工具链。它通过36个类型化工具和10个高级“超级工具”将Claude Desktop（和其他MCP客户端）连接到Flutter、Android SDK和iOS/XXcode工作流，这些工具可以编排完整的多步骤工作流。

您不用在终端和文档之间切换，而是用自然语言描述您想要的内容，服务器会执行正确的命令——内置验证、错误处理和回退策略。

支持的平台： 安卓·iOS·Flutter·macOS·Linux·Windows（部分）

特性

类别	工具	你能做什么
核心/健康	5	环境诊断、Flutter医生、设备发现
设备管理	9	列出、创建、启动和停止Android模拟器和iOS模拟器
Flutter开发	6	热重新加载会话、构建、测试、依赖关系管理
公用事业	4	Logcat、截图、模拟器启动/关闭
设置和配置	2	自动Flutter和Android SDK环境设置
超级工具（工作流）	10	结合多种原子工具的完整端到端工作流

超级工具——一次通话完成工作流程

工具	它做什么
`flutter_dev_session`	选择最佳可用设备，运行doctor，启动热重载--一个命令
`flutter_test_suite`	具有覆盖率报告的单元+小部件+集成测试
`flutter_release_build`	多平台发布版本（APK、App Bundle、IPA）
`flutter_deploy_pipeline`	端到端：测试→ 构建→ 标志
`flutter_fix_common_issues`	诊断并自动修复常见的Flutter构建错误
`flutter_inspector_session`	小部件检查会议
`mobile_device_manager`	跨平台的智能设备编排
`android_full_debug`	设备选择→ APK安装→ 发射→ logcat一步到位
`android_emulator_workflow`	AVD创建→ 开始→ wait → 准备好了
`ios_simulator_manager`	开机→ wait → 准备→ 截图生命周期管理

内置安全功能

所有shell命令在执行前都会根据满列表进行验证
危险模式检测阻止了注射尝试
对所有文件参数的路径遍历保护
通过以下方式进行运行时输入验证萨德
长时间运行的流程上的可配置超时

需求

要求	版本
Node.js	18.0.0或更高版本
npm或yarn	任何最新版本
Flutter SDK	3.0+（适用于Flutter工具）
Android SDK/Android Studio	任何最新版本（适用于Android工具）
Xcode	macOS上14+（适用于iOS工具）

您只需要您所使用的平台的SDK。即使缺少某些SDK，服务器也会启动并提供工具。

安装

选项1——使用npx运行（无需安装）

npx @cristianoaredes/mcp-mobile-server

选项2——全局安装

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

选项3——从源代码构建

git clone https://github.com/cristianoaredes/mcp-mobile-server.git
cd mcp-mobile-server
npm install
npm run build
npm start

Claude桌面设置

将服务器添加到Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%\Claude\claude_desktop_config.json
Linux： ~/.config/Claude/claude_desktop_config.json

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

保存后重新启动Claude Desktop。36个移动开发工具将自动出现。

用法示例

检查您的环境

Use the health_check tool to verify the mobile development server is working

Run flutter_doctor to check my Flutter setup

使用设备

List all connected Android devices and iOS simulators

Start a Flutter development session with hot reload on the best available device

构建和测试

Run the full test suite for my Flutter project at /path/to/project

Build release versions for Android and iOS

修复构建问题

My Flutter app won't build. Use flutter_fix_common_issues to diagnose and fix it.

从命令行验证安装

# After building from source:
npm run mcp:validate

# Expected output:
# ✅ Server configuration is valid
# ✅ 36 tools registered

项目结构

src/
  server.ts          # MCP server entry point
  tools/
    android.ts       # Android SDK tools
    ios.ts           # iOS / Xcode / Simulator tools
    flutter.ts       # Flutter SDK tools
    super-tools.ts   # High-level workflow automation
    setup-tools.ts   # Environment setup tools
  utils/
    process.ts       # Process execution and tracking
    security.ts      # Command validation and sandboxing
    fallbacks.ts     # Fallback strategies (ADB → native-run, etc.)
    tool-categories.ts # Tool registry

服务器使用JSON-RPC 2.0（标准MCP传输）通过stdio进行通信。

贡献

# Clone and install
git clone https://github.com/cristianoaredes/mcp-mobile-server.git
cd mcp-mobile-server
npm install

# Run in development mode (watch)
npm run dev

# Run tests
npm test

# Run linter and full CI check
npm run ci

看贡献.md 指南和 docs/ 查看完整的文档集。

文档

资源	描述
快速入门指南	在5分钟内跑步
工具参考	所有36个工具及其参数和示例
建筑	系统设计、安全层和ADR
Android工作流	Android开发指南
iOS工作流程	iOS开发指南
Flutter工作流	Flutter开发指南
故障排除	常见问题和解决方案

故障排除

未找到Flutter

# Run the automated setup tool
# In Claude Desktop: "Use flutter_setup_environment to install Flutter"

未配置Android SDK

# In Claude Desktop: "Use android_sdk_setup to configure Android"

没有可用设备

# List what's available
# "Use android_list_emulators and ios_list_simulators to see available devices"

# Or start a new one
# "Use android_start_emulator to launch an Android emulator"

Claude Desktop无法识别服务器

验证配置文件路径是否适用于您的操作系统
检查JSON是否有效（没有尾随逗号）
完全重新启动克劳德桌面
询问Claude：“使用health_check验证移动服务器”

许可证

麻省理工学院 --免费使用、修改和分发。

报告Bug · 请求功能 · 全部文件