MCP Appium Gestures

An MCP (Model Context Protocol) server providing resources and tools for Appium mobile gestures.

Features

Documentation resources for common Appium mobile gestures:
- Tap
- Swipe
- Scroll
- Pinch/Zoom
- Long Press
- Drag and Drop
- Double Tap
Tools to generate code for these gestures in different languages:
- JavaScript (WebdriverIO v9+ and below)
- Java (Appium Java Client)

Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-appium-gestures.git
cd mcp-appium-gestures

# Install dependencies
npm install

Usage

Start with stdio transport (for local use)

# Start the server with stdio transport
npm start
# or
npm run start:stdio

Start with SSE transport (for remote use)

# Start the server with SSE transport on default port (8080)
npm run start:sse

# Start the server with SSE transport on a custom port
npm run start:sse:port 3000

Development and Testing

# Test with mcp-cli
npm run dev

# Inspect with MCP Inspector
npm run inspect

Usage with Claude

To use this MCP server with Claude, you need to add it to your MCP settings configuration file. The location of this file depends on your platform:

For Cursor: /Users/[username]/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
For Claude Desktop: /Users/[username]/Library/Application Support/Claude/claude_desktop_config.json
For Cline or other MCP clients: Check your client's documentation for the configuration file location

Add the following configuration to the mcpServers object in the settings file:

{
  "mcpServers": {
    "appium-gestures": {
      "command": "npx",
      "disabled": false,
      "args": ["mcp-appium-gestures"],
      "autoApprove": [],
      "timeout": 300,
      "transportType": "stdio"
    }
  }
}

Once configured, you can use the MCP server's tools and resources directly in Claude:

<use_mcp_tool>
<server_name>appium-gestures</server_name>
<tool_name>generate-tap-code</tool_name>
<arguments>
{
  "language": "javascript",
  "useElement": true,
  "elementId": "login-button"
}
</arguments>
</use_mcp_tool>

Or access resources:

<access_mcp_resource>
<server_name>appium-gestures</server_name>
<uri>gesture://tap</uri>
</access_mcp_resource>

Resources

The server provides documentation resources for the following gestures:

gesture://tap - Tap gesture documentation
gesture://swipe - Swipe gesture documentation
gesture://scroll - Scroll gesture documentation
gesture://pinch-zoom - Pinch and zoom gestures documentation
gesture://long-press - Long press gesture documentation
gesture://drag-drop - Drag and drop gesture documentation
gesture://double-tap - Double tap gesture documentation

You can also access a specific gesture by name using the template: gesture://{name}

Tools

The server provides the following tools to generate code for Appium gestures:

generate-tap-code

Generates code for tap gesture.

Parameters:

language: 'javascript' or 'java'
useElement: boolean - whether to tap on an element or at coordinates
elementId: string (required if useElement is true) - the element ID to tap on
x: number (required if useElement is false) - x coordinate to tap at
y: number (required if useElement is false) - y coordinate to tap at

generate-swipe-code

Generates code for swipe gesture.

Parameters:

language: 'javascript' or 'java'
startX: number - starting x coordinate
startY: number - starting y coordinate
endX: number - ending x coordinate
endY: number - ending y coordinate
duration: number (optional, default: 500) - duration of the swipe in milliseconds

generate-scroll-code

Generates code for scroll gesture.

Parameters:

language: 'javascript' or 'java'
direction: 'up', 'down', 'left', or 'right'
useElement: boolean (optional, default: false) - whether to scroll to an element
elementId: string (optional) - the element ID to scroll to
distance: number (optional, default: 300) - distance to scroll

generate-long-press-code

Generates code for long press gesture.

Parameters:

language: 'javascript' or 'java'
useElement: boolean - whether to long press on an element or at coordinates
elementId: string (required if useElement is true) - the element ID to long press on
x: number (required if useElement is false) - x coordinate to long press at
y: number (required if useElement is false) - y coordinate to long press at
duration: number (optional, default: 2000) - duration of the long press in milliseconds

generate-double-tap-code

Generates code for double tap gesture.

Parameters:

language: 'javascript' or 'java'
useElement: boolean - whether to double tap on an element or at coordinates
elementId: string (required if useElement is true) - the element ID to double tap on
x: number (required if useElement is false) - x coordinate to double tap at
y: number (required if useElement is false) - y coordinate to double tap at
pauseDuration: number (optional, default: 200) - pause duration between taps in milliseconds

License

MIT

MCP Appium Gestures