Integrations
Provides capabilities for testing and automating Android applications, including device management, app installation, and UI interaction through the Appium framework.
Enables mobile app automation through Appium, supporting element interactions, app management, device controls, and advanced features like context switching and custom gestures.
Supports automation of iOS applications on devices and simulators, including element interactions and app management through the Appium framework.
MCP Appium 服务器
使用 Appium 实现移动应用自动化的模型上下文协议 (MCP) 服务器实现。
先决条件
- Node.js(v14 或更高版本)
- Java 开发工具包 (JDK)
- Android SDK(用于Android测试)
- Xcode(用于 iOS 测试,仅限 macOS)
- Appium 服务器
- Android 设备或模拟器 / iOS 设备或模拟器
设置
- 安装依赖项:
- 安装并启动 Appium 服务器:
- 设置 Android 设备/模拟器:
- 在您的 Android 设备上启用开发者选项
- 启用 USB 调试
- 通过 USB 连接设备或启动模拟器
- 使用
adb devices
验证设备是否已连接
运行测试
- 构建项目:
- 启动 MCP 服务器:
- 在新的终端中,运行测试:
测试配置
示例测试使用 Android 设置应用作为演示。要测试您自己的应用,请执行以下操作:
- 编辑
examples/appium-test.ts
:- 更新
deviceName
以匹配您的设备 - 将
app
路径设置为 APK 文件,或者 - 更新已安装应用的
appPackage
和appActivity
- 更新
- 通用功能配置:
可用操作
MCP 服务器支持各种 Appium 操作:
- 元素交互:
- 查找元素
- 点击
- 输入文本
- 滚动到元素
- 长按
- 应用程序管理:
- 启动/关闭应用程序
- 重置应用程序
- 获取当前包裹/活动
- 设备控制:
- 屏幕方向
- 键盘处理
- 设备锁定/解锁
- 截图
- 电池信息
- 高级功能:
- 上下文切换(Native/WebView)
- 文件操作
- 通知
- 自定义手势
故障排除
- 未找到设备:
- 检查
adb devices
输出 - 验证 USB 调试已启用
- 尝试重新连接设备
- 检查
- 应用程序未安装:
- 验证APK路径是否正确
- 检查设备是否有足够的存储空间
- 确保应用程序已签名以进行调试
- 未找到元素:
- 使用 Appium Inspector 验证选择器
- 检查元素是否在屏幕上可见
- 尝试不同的定位器策略
- 连接问题:
- 验证 Appium 服务器正在运行
- 检查端口冲突
- 确保设置了正确的功能
贡献
请随意提交问题并请求附加功能或错误修复。
执照
麻省理工学院
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
模型上下文协议 (MCP) 服务器,使用 Appium 实现移动应用自动化,通过标准化协议支持各种设备交互、元素操作和应用管理。
Related Resources
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol (MCP) server implementation for interacting with Phabricator API. This server allows LLMs to interact with Phabricator through a standardized interface.Last updated -5Python
- AsecurityAlicenseAqualityA beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.Last updated -3936JavaScriptApache 2.0
- -securityFlicense-qualityThis MCP server implementation allows users to manage and expose actions as tools from their Integration App workspace through the Model Context Protocol.Last updated -1014JavaScript
- -security-license-qualityA Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.Last updated -2