appium/appium-mcp

Developer tools 공식

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

512 stars 95 forks 품질 86 트렌드 42Apache-2.0

Repository Install

스테로이드 복용 중인 아피움 MCP!

개요

MCP Appium은 AI 비서들에게 모바일 자동화를 위한 강력한 도구 모음을 제공하기 위해 설계된 지능형 MCP(모델 컨텍스트 프로토콜) 서버입니다. 이 서버는 자연어 상호작용, 지능형 위치 생성, 자동화된 테스트 생성을 가능하게 하여 Android 및 iOS 플랫폼 모두에서 모바일 앱 테스트를 간소화합니다. - : Android(UiAutomator2)와 iOS(XCUITest) 모두에서 테스트를 자동화합니다. - : 비전 모델을 기반으로 한 자연어 설명을 사용해 UI 요소를 찾으며, 복잡한 XPath나 셀렉터가 필요 없습니다. - : 우선순위 기반 전략을 이용한 AI 기반 요소 식별. - : 로컬 모바일 기기에서 세션을 쉽게 생성하고 관리할 수 있습니다. - : 클릭, 텍스트 입력, 스크린샷, 요소 찾기 등의 작업을 수행합니다. - : 자연어 설명에서 Java/TestNG 테스트 코드를 생성합니다. - : 업계 모범 사례를 따르는 내장 템플릿을 활용합니다. - : 다양한 환경에 맞는 기능과 설정을 맞춤화합니다.

개요(AI 번역)

MCP Appium은 AI 비서들에게 모바일 자동화를 위한 강력한 도구 모음을 제공하기 위해 설계된 지능형 MCP(모델 컨텍스트 프로토콜) 서버입니다. 이 서버는 자연어 상호작용, 지능형 위치 생성, 자동화된 테스트 생성을 가능하게 하여 Android 및 iOS 플랫폼 모두에서 모바일 앱 테스트를 간소화합니다.

🚀 특징

크로스 플랫폼 지원: Android(UiAutomator2)와 iOS(XCUITest) 모두에서 테스트를 자동화합니다.
AI 기반 요소 찾기: 비전 모델을 기반으로 한 자연어 설명을 사용해 UI 요소를 찾을 수 있으며, 복잡한 XPath나 셀렉터가 필요 없습니다.
지능형 위치 생성(Intelligent Locator Generation): AI 기반 요소 식별, 우선순위 기반 전략.
인터랙티브 세션 관리: 로컬 모바일 기기에서 세션을 쉽게 생성하고 관리할 수 있습니다.
스마트 요소 상호작용: 클릭, 텍스트 입력, 스크린샷, 요소 찾기 등의 동작을 수행합니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

MCP Appium - MCP server for Mobile Development and Automation | iOS, Android, Simulator, Emulator, and Real Devices

MCP Appium is an intelligent MCP (Model Context Protocol) server designed to empower AI assistants with a robust suite of tools for mobile automation. It streamlines mobile app testing by enabling natural language interactions, intelligent locator generation, and automated test creation for both Android and iOS platforms.

Features
Prerequisites
Installation
Configuration
Remote server security and trust model
Available Tools
Plugin API
Client Support
Usage Examples
Contributing
License

🚀 Features

Cross-Platform Support: Automate tests for both Android (UiAutomator2) and iOS (XCUITest).
AI-Powered Element Finding: Locate UI elements using natural language descriptions powered by vision models - no need for complex XPath or selectors.
Intelligent Locator Generation: AI-powered element identification using priority-based strategies.
Interactive Session Management: Easily create and manage sessions on local mobile devices.
Smart Element Interactions: Perform actions like clicks, text input, screenshots, and element finding.
Automated Test Generation: Generate Java/TestNG test code from natural language descriptions.
Page Object Model Support: Utilize built-in templates that follow industry best practices.
Flexible Configuration: Customize capabilities and settings for different environments.
Multilingual Support: Use your native language - AI handles all interactions naturally in any language (English, Spanish, Chinese, Japanese, Korean, etc.).

📋 Prerequisites

Before you begin, ensure you have the following installed:

System Requirements

Node.js (v22 or higher)
npm or yarn
Java Development Kit (JDK) (8 or higher)
Android SDK (for Android testing)
Xcode (for iOS testing on macOS)

MCP Appium supports two driver modes:

Embedded local drivers: when appium_session_management creates an android or ios session without remoteServerUrl, MCP Appium uses the bundled appium-uiautomator2-driver or appium-xcuitest-driver dependency directly. You still need the platform toolchains below, but you do not need to install a global Appium server or run appium driver install uiautomator2 / appium driver install xcuitest for this mode.

GitHub에서 전체 README 보기

설치

npx appium-mcp@latest

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "appium-mcp": {
      "disabled": false,
      "timeout": 100,
      "type": "stdio",
      "command": "npx",
      "args": ["appium-mcp@latest"],
      "env": {
        "ANDROID_HOME": "/path/to/android/sdk",
        "CAPABILITIES_CONFIG": "/path/to/your/capabilities.json"
      }
    }
  }
}