MCP Appium Gestures
@AppiumTestDistribution
This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..
Overview
What is MCP Appium Gestures?
MCP Appium Gestures is an MCP server that provides resources and tools for common Appium mobile gestures. It offers gesture documentation and generates code for these gestures in JavaScript (WebdriverIO) and Java (Appium Java Client).
How to use MCP Appium Gestures?
Clone the repository, install dependencies with npm install, and start the server using stdio transport (npm start) or SSE transport (npm run start:sse). Configure it in your MCP settings file for Claude Desktop, Cursor, or other MCP clients, then access gesture resources via URIs like gesture://tap or use tools like generate-tap-code.
Key features of MCP Appium Gestures
- Documentation resources for seven common Appium mobile gestures
- Code generation tools for JavaScript (WebdriverIO) and Java
- Supports tap, swipe, scroll, pinch/zoom, long press, drag and drop, and double tap
- Configurable transports: stdio for local use, SSE for remote use
- Parameters for element-based or coordinate-based gestures, with optional duration
Use cases of MCP Appium Gestures
- Automating mobile app testing with gesture interactions
- Generating code snippets for common gestures in different languages
- Learning correct Appium gesture syntax via resource documentation
- Integrating gesture support into AI-driven test generation workflows
FAQ from MCP Appium Gestures
What gestures does MCP Appium Gestures support?
It supports tap, swipe, scroll, pinch/zoom, long press, drag and drop, and double tap.
What languages are available for code generation?
JavaScript (WebdriverIO v9+ and below) and Java (Appium Java Client).
How do I start the server with SSE transport?
Run npm run start:sse for default port 8080, or npm run start:sse:port 3000 for a custom port.
How do I configure this server for Claude?
Add the server to your MCP settings JSON file (e.g., claude_desktop_config.json) under mcpServers with the command npx and args: ["mcp-appium-gestures"].
Can I generate code for a gesture on a specific element?
Yes. For tools like generate-tap-code and generate-long-press-code, set useElement: true and provide an elementId.
