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:

appium-gestures
generate-tap-code

{
  "language": "javascript",
  "useElement": true,
  "elementId": "login-button"
}

Or access resources:

appium-gestures
gesture://tap

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