MCP Mobile Server

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（部分）

______________________________________________________________________

特性

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

内置安全功能

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

______________________________________________________________________

需求

您只需要您所使用的平台的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/ 查看完整的文档集。

______________________________________________________________________

文档

______________________________________________________________________

故障排除

未找到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无法识别服务器

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

______________________________________________________________________

许可证

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

______________________________________________________________________

](https://github.com/cristianoaredes/mcp-mobile-server)