@iflow-mcp/appiumtestdistribution-mcp-appium-gestures 1.0.0

package/6139_process.log

@@ -0,0 +1,3 @@
+[2026-02-09 21:48:23] [✓] 步骤2: 阅读代码完成 - 项目确认为Node.js MCP服务端项目，支持stdio和SSE协议
+[2026-02-09 21:48:48] [✓] 步骤3: 本地测试完成 - 成功检测到5个工具
+[2026-02-09 21:48:56] [✓] 步骤4: 创建并推送分支完成 - 成功推送到iflow分支

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 AppiumTestDistribution
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,198 @@
+[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/appiumtestdistribution-mcp-appium-gestures-badge.png)](https://mseep.ai/app/appiumtestdistribution-mcp-appium-gestures)
+
+# 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
+
+```bash
+# 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)
+
+```bash
+# Start the server with stdio transport
+npm start
+# or
+npm run start:stdio
+```
+
+### Start with SSE transport (for remote use)
+
+```bash
+# 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
+
+```bash
+# 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:
+
+```json
+{
+  "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

package/language.json

@@ -0,0 +1 @@
+nodejs

package/package.json

@@ -0,0 +1 @@
+{"name": "@iflow-mcp/appiumtestdistribution-mcp-appium-gestures", "version": "1.0.0", "type": "module", "main": "src/index.js", "bin": {"iflow-mcp-appiumtestdistribution-mcp-appium-gestures": "src/index.js"}, "scripts": {"start": "node src/index.js", "start:stdio": "node src/index.js", "start:sse": "node src/index.js --sse", "start:sse:port": "node src/index.js --sse --port=", "dev": "npx fastmcp dev src/index.js", "inspect": "npx fastmcp inspect src/index.js", "test": "echo \"Error: no test specified\" && exit 1"}, "author": "", "license": "MIT", "description": "MCP server providing resources and tools for Appium mobile gestures", "dependencies": {"@modelcontextprotocol/sdk": "^1.11.0", "fastmcp": "^1.23.2", "zod": "^3.24.3"}}

package/package_name

@@ -0,0 +1 @@
+@iflow-mcp/appiumtestdistribution-mcp-appium-gestures

package/push_info.json

@@ -0,0 +1,5 @@
+{
+  "push_platform": "github",
+  "fork_url": "https://github.com/iflow-mcp/appiumtestdistribution-mcp-appium-gestures",
+  "fork_branch": "iflow"
+}

package/src/index.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+import server from './server.js';
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+const useSSE = args.includes('--sse');
+const port = args.find((arg) => arg.startsWith('--port='))?.split('=')[1] || '8080';
+
+// Start the server with the appropriate transport
+async function startServer() {
+  console.log("Starting Appium Gestures MCP Server...");
+  
+  try {
+    if (useSSE) {
+      // Start with SSE transport
+      server.start({
+        transportType: 'sse',
+        sse: {
+          endpoint: '/sse',
+          port: parseInt(port, 10),
+        },
+      });
+      
+      console.log(`Server started with SSE transport on http://localhost:${port}/sse`);
+      console.log("Waiting for client connections...");
+    } else {
+      // Start with stdio transport
+      server.start({
+        transportType: 'stdio',
+      });
+      
+      console.log("Server started with stdio transport");
+      console.log("Waiting for client connections...");
+    }
+  } catch (error) {
+    console.error("Error starting server:", error);
+    process.exit(1);
+  }
+}
+
+// Start the server
+startServer();

package/src/resources/double-tap-gesture.js

@@ -0,0 +1,97 @@
+/**
+ * Resource for double tap gesture documentation
+ */
+export default function doubleTapGesture(server) {
+  server.addResource({
+    uri: 'gesture://double-tap',
+    name: 'Double Tap Gesture',
+    mimeType: 'text/markdown',
+    async load() {
+      return {
+        text: `
+# Double Tap Gesture in Appium
+
+The double tap gesture simulates tapping twice in quick succession on the same location, commonly used for zooming in on maps or images.
+
+## WebdriverIO Example (v9+)
+\`\`\`javascript
+// Double tap on an element
+// Note: In WebdriverIO v9+, you can use the doubleClick method
+const element = $('~element-id');
+await element.doubleClick();
+\`\`\`
+
+## WebdriverIO Example (below v9)
+\`\`\`javascript
+// Double tap at specific coordinates using touchAction
+await driver.touchAction([
+  { action: 'tap', x: 100, y: 200 },
+  { action: 'wait', ms: 100 },
+  { action: 'tap', x: 100, y: 200 }
+]);
+
+// Using the Gestures helper class
+const { x, y } = await element.getLocation();
+const centerX = x + (await element.getSize()).width / 2;
+const centerY = y + (await element.getSize()).height / 2;
+
+// Execute double tap gesture
+await driver
+  .action('pointer')
+  .move(centerX, centerY)
+  .down()
+  .up()
+  .pause(100)
+  .down()
+  .up()
+  .perform();
+\`\`\`
+
+## Appium Java Client Example
+\`\`\`java
+// Implementation from VodQaAdvancedAppium repository
+@Test
+public void doubleTap() throws InterruptedException {
+  // Setup
+  login();
+  Thread.sleep(5000);
+  driver.findElement(AppiumBy.accessibilityId("doubleTap")).click();
+  
+  // Get the element to double tap
+  WebElement element = new WebDriverWait(driver, Duration.ofMillis(30))
+          .until(elementToBeClickable(AppiumBy.accessibilityId("doubleTapMe")));
+  
+  // Get element location
+  Point source = element.getLocation();
+  
+  // Create finger gesture with touch pointer
+  PointerInput finger = new PointerInput(PointerInput.Kind.TOUCH, "finger");
+  Sequence tap = new Sequence(finger, 1);
+  
+  // First tap
+  tap.addAction(finger.createPointerMove(Duration.ofMillis(0),
+          PointerInput.Origin.viewport(), source.x, source.y));
+  tap.addAction(finger.createPointerDown(PointerInput.MouseButton.LEFT.asArg()));
+  tap.addAction(finger.createPointerUp(PointerInput.MouseButton.LEFT.asArg()));
+  
+  // Small pause between taps
+  tap.addAction(new Pause(finger, Duration.ofMillis(200)));
+  
+  // Second tap
+  tap.addAction(finger.createPointerDown(PointerInput.MouseButton.LEFT.asArg()));
+  tap.addAction(finger.createPointerUp(PointerInput.MouseButton.LEFT.asArg()));
+  
+  // Perform the action
+  driver.perform(Collections.singletonList(tap));
+  
+  // Wait to see the result
+  Thread.sleep(4000);
+}
+\`\`\`
+
+This implementation uses the W3C Actions API which provides more precise control over pointer movements and timing, and is the recommended approach in newer versions of Appium.
+`,
+      };
+    },
+  });
+}

package/src/resources/drag-drop-gesture.js

@@ -0,0 +1,91 @@
+/**
+ * Resource for drag and drop gesture documentation
+ */
+export default function dragDropGesture(server) {
+  server.addResource({
+    uri: 'gesture://drag-drop',
+    name: 'Drag and Drop Gesture',
+    mimeType: 'text/markdown',
+    async load() {
+      return {
+        text: `
+# Drag and Drop Gesture in Appium
+
+The drag and drop gesture simulates dragging an element from one location to another, commonly used in UI testing for moving items between containers.
+
+## WebdriverIO Example (v9+)
+\`\`\`javascript
+// Drag and drop element to another element
+const elem = $('#someElem');
+const target = $('#someTarget');
+await elem.dragAndDrop(target);
+
+// Drag and drop relative from current position
+await elem.dragAndDrop({ x: 100, y: 200 });
+
+// Drag and drop with custom duration
+await elem.dragAndDrop(target, { duration: 2000 }); // 2 seconds
+\`\`\`
+
+## WebdriverIO Example (below v9)
+\`\`\`javascript
+// Drag and drop using coordinates with touchAction
+await driver.touchAction([
+  { action: 'press', x: 100, y: 200 },
+  { action: 'wait', ms: 500 },
+  { action: 'moveTo', x: 300, y: 400 },
+  { action: 'release' }
+]);
+
+// Using the Gestures helper class
+const { x: sourceX, y: sourceY } = await sourceElem.getLocation();
+const { x: targetX, y: targetY } = await targetElem.getLocation();
+
+await driver
+  .action('pointer')
+  .move(sourceX, sourceY)
+  .down()
+  .pause(500)
+  .move({ duration: 1000, x: targetX, y: targetY })
+  .up()
+  .perform();
+\`\`\`
+
+## Appium Java Client Example
+\`\`\`java
+// Implementation from VodQaAdvancedAppium repository
+// Find the element to drag
+WebElement dragMe = new WebDriverWait(driver, Duration.ofSeconds(30))
+        .until(elementToBeClickable(AppiumBy.accessibilityId("dragMe")));
+
+// Get source location
+Point source = dragMe.getLocation();
+
+// Find the drop target
+Point target = driver.findElement(AppiumBy.accessibilityId("dropzone")).getLocation();
+
+// Create finger gesture with touch pointer
+PointerInput finger = new PointerInput(PointerInput.Kind.TOUCH, "finger");
+Sequence dragNDrop = new Sequence(finger, 1);
+
+// Press, move and release
+dragNDrop.addAction(finger.createPointerMove(Duration.ofMillis(0),
+        PointerInput.Origin.viewport(), source.x, source.y));
+dragNDrop.addAction(finger.createPointerDown(PointerInput.MouseButton.MIDDLE.asArg()));
+dragNDrop.addAction(finger.createPointerMove(Duration.ofMillis(600),
+        PointerInput.Origin.viewport(), target.x, target.y));
+dragNDrop.addAction(finger.createPointerUp(PointerInput.MouseButton.MIDDLE.asArg()));
+
+// Perform the action
+driver.perform(Collections.singletonList(dragNDrop));
+
+// Verify the drop was successful
+assertEquals(driver.findElements(AppiumBy.accessibilityId("success")).size(), 1);
+\`\`\`
+
+This implementation uses the W3C Actions API which provides more precise control over pointer movements and is the recommended approach in newer versions of Appium.
+        `,
+      };
+    },
+  });
+}

package/src/resources/gesture-by-name.js

@@ -0,0 +1,43 @@
+/**
+ * Dynamic resource for gesture documentation by name
+ */
+export default function gestureByName(server) {
+  server.addResourceTemplate({
+    uriTemplate: 'gesture://{name}',
+    name: 'Gesture by Name',
+    mimeType: 'text/markdown',
+    arguments: [
+      {
+        name: 'name',
+        description: 'Name of the gesture',
+        required: true,
+        enum: ['tap', 'swipe', 'scroll', 'pinch-zoom', 'long-press', 'drag-drop', 'double-tap'],
+      },
+    ],
+    async load({ name }) {
+      // Map of supported gestures
+      const gestures = {
+        tap: 'gesture://tap',
+        swipe: 'gesture://swipe',
+        scroll: 'gesture://scroll',
+        'pinch-zoom': 'gesture://pinch-zoom',
+        'long-press': 'gesture://long-press',
+        'drag-drop': 'gesture://drag-drop',
+        'double-tap': 'gesture://double-tap',
+      };
+
+      if (!gestures[name]) {
+        return {
+          text: `Gesture "${name}" not found. Available gestures: ${Object.keys(
+            gestures
+          ).join(', ')}`,
+        };
+      }
+
+      // Redirect to the specific gesture resource
+      return {
+        text: `Redirecting to ${gestures[name]}...`,
+      };
+    },
+  });
+}

package/src/resources/index.js

@@ -0,0 +1,21 @@
+// Export all resources
+import tapGesture from './tap-gesture.js';
+import swipeGesture from './swipe-gesture.js';
+import scrollGesture from './scroll-gesture.js';
+import pinchZoomGesture from './pinch-zoom-gesture.js';
+import longPressGesture from './long-press-gesture.js';
+import dragDropGesture from './drag-drop-gesture.js';
+import doubleTapGesture from './double-tap-gesture.js';
+import gestureByName from './gesture-by-name.js';
+
+export default function registerResources(server) {
+  // Register all resources
+  tapGesture(server);
+  swipeGesture(server);
+  scrollGesture(server);
+  pinchZoomGesture(server);
+  longPressGesture(server);
+  dragDropGesture(server);
+  doubleTapGesture(server);
+  gestureByName(server);
+}

package/src/resources/long-press-gesture.js

@@ -0,0 +1,77 @@
+/**
+ * Resource for long press gesture documentation
+ */
+export default function longPressGesture(server) {
+  server.addResource({
+    uri: 'gesture://long-press',
+    name: 'Long Press Gesture',
+    mimeType: 'text/markdown',
+    async load() {
+      return {
+        text: `
+# Long Press Gesture in Appium
+
+The long press gesture simulates pressing and holding a finger on a specific element or at specific coordinates.
+
+## WebdriverIO Example (v9+)
+\`\`\`javascript
+// Long press on an element
+const contacts = $('~Contacts');
+// Long press with default duration (1500ms)
+await contacts.longPress();
+// Long press with custom duration and offset
+await contacts.longPress({ duration: 5000 }); // 5 seconds
+// Long press with offset from center point of element
+await contacts.longPress({ x: 30, y: 10 });
+\`\`\`
+
+## WebdriverIO Example (below v9)
+\`\`\`javascript
+// Long press on an element
+await $('~element-id').touchAction('longPress');
+
+// Long press at specific coordinates
+await driver.touchAction([
+  { action: 'longPress', x: 100, y: 200, ms: 2000 },
+  { action: 'release' }
+]);
+\`\`\`
+
+## Appium Java Client Example (W3C Actions API)
+\`\`\`java
+// Long press on an element
+WebElement element = driver.findElement(AppiumBy.accessibilityId("elementId"));
+Point source = element.getLocation();
+PointerInput finger = new PointerInput(PointerInput.Kind.TOUCH, "finger");
+Sequence sequence = new Sequence(finger, 1);
+
+// Move to element, press down, wait, then release
+sequence.addAction(finger.createPointerMove(Duration.ofMillis(0),
+        PointerInput.Origin.viewport(), source.x, source.y));
+sequence.addAction(finger.createPointerDown(PointerInput.MouseButton.LEFT.asArg()));
+// Hold for 2 seconds (2000 milliseconds)
+sequence.addAction(new Pause(finger, Duration.ofMillis(2000)));
+sequence.addAction(finger.createPointerUp(PointerInput.MouseButton.LEFT.asArg()));
+
+// Perform the action
+driver.perform(Collections.singletonList(sequence));
+
+// Long press at specific coordinates
+PointerInput finger = new PointerInput(PointerInput.Kind.TOUCH, "finger");
+Sequence sequence = new Sequence(finger, 1);
+
+sequence.addAction(finger.createPointerMove(Duration.ofMillis(0),
+        PointerInput.Origin.viewport(), 100, 200));
+sequence.addAction(finger.createPointerDown(PointerInput.MouseButton.LEFT.asArg()));
+// Hold for 2 seconds (2000 milliseconds)
+sequence.addAction(new Pause(finger, Duration.ofMillis(2000)));
+sequence.addAction(finger.createPointerUp(PointerInput.MouseButton.LEFT.asArg()));
+
+// Perform the action
+driver.perform(Collections.singletonList(sequence));
+\`\`\`
+        `,
+      };
+    },
+  });
+}