MCP Appium Server

基本能力

产品定位

appium-mcp 是一个用于移动应用自动化测试的 MCP 服务器实现，支持通过 Appium 进行跨平台的自动化测试。

核心功能

1. 元素交互：支持查找元素、点击、输入文本、滚动到元素、长按等操作。
2. 应用管理：支持启动/关闭应用、重置应用、获取当前包名/活动等。
3. 设备控制：支持屏幕方向调整、键盘处理、设备锁定/解锁、截图、电池信息获取等。
4. 高级功能：支持上下文切换（Native/WebView）、文件操作、通知处理、自定义手势等。

适用场景

1. 移动应用的自动化测试。
2. 跨平台（Android/iOS）的自动化测试。
3. 需要复杂交互和高级功能的自动化测试场景。

工具列表

1. Appium Server：用于执行自动化测试的核心工具。
2. Node.js：运行 JavaScript 代码的环境。
3. Android SDK：用于 Android 设备的测试。
4. Xcode：用于 iOS 设备的测试（仅 macOS）。

常见问题解答

1. 设备未找到：检查 adb devices 输出，确保 USB 调试已启用。
2. 应用未安装：验证 APK 路径是否正确，检查设备存储空间。
3. 元素未找到：使用 Appium Inspector 验证选择器，确保元素可见。
4. 连接问题：确保 Appium 服务器正在运行，检查端口冲突。

使用教程

使用依赖

1. 安装 Node.js（v14 或更高版本）。
2. 安装 Java Development Kit (JDK)。
3. 安装 Android SDK（用于 Android 测试）。
4. 安装 Xcode（用于 iOS 测试，仅 macOS）。
5. 安装 Appium Server。
6. 准备 Android 设备或模拟器 / iOS 设备或模拟器。

安装教程

1. 安装依赖：

npm install

1. 安装并启动 Appium 服务器：

npm install -g appium
appium

1. 设置 Android 设备/模拟器：
2. 启用开发者选项。
3. 启用 USB 调试。
4. 通过 USB 连接设备或启动模拟器。
5. 使用 adb devices 验证设备是否连接。

调试方式

1. 构建项目：

npm run build

1. 启动 MCP 服务器：

npm run dev

1. 运行测试：

npm test

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。