MCP Appium Server

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) 服务器实现。

先决条件

  1. Node.js(v14 或更高版本)
  2. Java 开发工具包 (JDK)
  3. Android SDK(用于Android测试)
  4. Xcode(用于 iOS 测试,仅限 macOS)
  5. Appium 服务器
  6. Android 设备或模拟器 / iOS 设备或模拟器

设置

  1. 安装依赖项:
npm install
  1. 安装并启动 Appium 服务器:
npm install -g appium appium
  1. 设置 Android 设备/模拟器:
    • 在您的 Android 设备上启用开发者选项
    • 启用 USB 调试
    • 通过 USB 连接设备或启动模拟器
    • 使用adb devices验证设备是否已连接

运行测试

  1. 构建项目:
npm run build
  1. 启动 MCP 服务器:
npm run dev
  1. 在新的终端中,运行测试:
npm test

测试配置

示例测试使用 Android 设置应用作为演示。要测试您自己的应用,请执行以下操作:

  1. 编辑examples/appium-test.ts
    • 更新deviceName以匹配您的设备
    • app路径设置为 APK 文件,或者
    • 更新已安装应用的appPackageappActivity
  2. 通用功能配置:
const capabilities: AppiumCapabilities = { platformName: 'Android', deviceName: 'YOUR_DEVICE_NAME', automationName: 'UiAutomator2', // For installing and testing an APK: app: './path/to/your/app.apk', // OR for testing an installed app: appPackage: 'your.app.package', appActivity: '.MainActivity', noReset: true };

可用操作

MCP 服务器支持各种 Appium 操作:

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

故障排除

  1. 未找到设备:
    • 检查adb devices输出
    • 验证 USB 调试已启用
    • 尝试重新连接设备
  2. 应用程序未安装:
    • 验证APK路径是否正确
    • 检查设备是否有足够的存储空间
    • 确保应用程序已签名以进行调试
  3. 未找到元素:
    • 使用 Appium Inspector 验证选择器
    • 检查元素是否在屏幕上可见
    • 尝试不同的定位器策略
  4. 连接问题:
    • 验证 Appium 服务器正在运行
    • 检查端口冲突
    • 确保设置了正确的功能

贡献

请随意提交问题并请求附加功能或错误修复。

执照

麻省理工学院

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

模型上下文协议 (MCP) 服务器,使用 Appium 实现移动应用自动化,通过标准化协议支持各种设备交互、元素操作和应用管理。

  1. 先决条件
    1. 设置
      1. 运行测试
        1. 测试配置
          1. 可用操作
            1. 故障排除
              1. 贡献
                1. 执照

                  Related MCP Servers

                  • -
                    security
                    F
                    license
                    -
                    quality
                    A 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 -
                    5
                    Python
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A 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 -
                    3
                    9
                    36
                    JavaScript
                    Apache 2.0
                  • -
                    security
                    F
                    license
                    -
                    quality
                    This MCP server implementation allows users to manage and expose actions as tools from their Integration App workspace through the Model Context Protocol.
                    Last updated -
                    10
                    14
                    JavaScript
                  • -
                    security
                    -
                    license
                    -
                    quality
                    A 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

                  View all related MCP servers

                  ID: pu6x5f1oro