appium-mcp 1.34.0 → 1.34.2

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [1.34.2](https://github.com/appium/appium-mcp/compare/v1.34.1...v1.34.2) (2026-03-23)
+
+### Miscellaneous Chores
+
+* add zip/unzip asserts to distribute them in small size ([#227](https://github.com/appium/appium-mcp/issues/227)) ([126f2dd](https://github.com/appium/appium-mcp/commit/126f2dd7ede8696853eb887d7310d6aa22ea8e68))
+
+## [1.34.1](https://github.com/appium/appium-mcp/compare/v1.34.0...v1.34.1) (2026-03-23)
+
+### Miscellaneous Chores
+
+* exclude src/tests ([#226](https://github.com/appium/appium-mcp/issues/226)) ([0c2a72d](https://github.com/appium/appium-mcp/commit/0c2a72db5bde392891482b9c3849bf9b71b51a87))
+
 ## [1.34.0](https://github.com/appium/appium-mcp/compare/v1.33.0...v1.34.0) (2026-03-22)
 
 ### Features

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "appium-mcp",
   "mcpName": "io.github.appium/appium-mcp",
-  "version": "1.34.0",
+  "version": "1.34.2",
   "type": "module",
   "repository": {
     "type": "git",
@@ -36,7 +36,10 @@
     "index-docs": "node dist/scripts/simple-index-documentation.js",
     "query-docs": "node dist/scripts/simple-query-documentation.js",
     "sync-version": "node scripts/sync-version.mjs",
-    "version": "npm run sync-version"
+    "version": "npm run sync-version",
+    "zip-assets": "node scripts/zip-assets.mjs zip",
+    "unzip-assets": "node scripts/zip-assets.mjs unzip",
+    "postinstall": "node scripts/zip-assets.mjs unzip"
   },
   "author": "",
   "license": "Apache-2.0",
@@ -85,6 +88,7 @@
   "files": [
     "scripts",
     "src",
+    "!src/tests",
     "dist",
     "CHANGELOG.md",
     "README.md",

package/scripts/zip-assets.mjs

@@ -0,0 +1,55 @@
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
+import fs from 'node:fs/promises';
+
+import {zip as appiumZip} from '@appium/support';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Adjust these paths for your use case
+const ZIP_SOURCE_DIR = path.join(__dirname, '..', 'src', 'resources', 'submodules');
+const ZIP_OUTPUT_PATH = path.join(__dirname, '..', 'src', 'resources', 'submodules.zip');
+const UNZIP_TARGET_DIR = path.join(__dirname, '..', 'src', 'resources', 'submodules');
+
+export async function zipAssets() {
+  const zipBase64 = await appiumZip.toInMemoryZip(ZIP_SOURCE_DIR);
+  const zipBuffer = Buffer.from(zipBase64, 'base64');
+  await fs.writeFile(ZIP_OUTPUT_PATH, zipBuffer);
+  console.log(`Zipped ${ZIP_SOURCE_DIR} -> ${ZIP_OUTPUT_PATH}`);
+}
+
+const fileExists = async (filePath) => {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+export async function unzipAssets() {
+  if (!(await fileExists(ZIP_OUTPUT_PATH))) {
+    console.log(`Target directory ${ZIP_OUTPUT_PATH} does not exist. Skipping unzip.`);
+    return;
+  }
+  await appiumZip.extractAllTo(ZIP_OUTPUT_PATH, UNZIP_TARGET_DIR);
+  console.log(`Unzipped ${ZIP_OUTPUT_PATH} -> ${UNZIP_TARGET_DIR}`);
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const cmd = process.argv[2];
+  if (cmd === 'zip') {
+    zipAssets().catch((e) => {
+      console.error(e);
+      process.exitCode = 1;
+    });
+  } else if (cmd === 'unzip') {
+    unzipAssets().catch((e) => {
+      console.error(e);
+      process.exitCode = 1;
+    });
+  } else {
+    console.log('Usage: node zip-assets.mjs [zip|unzip]');
+  }
+}

package/server.json

@@ -3,12 +3,12 @@
   "name": "io.github.appium/appium-mcp",
   "title": "MCP Appium - Mobile Development and Automation Server",
   "description": "MCP server for Appium mobile automation on iOS and Android devices with test creation tools.",
-  "version": "1.34.0",
+  "version": "1.34.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "appium-mcp",
-      "version": "1.34.0",
+      "version": "1.34.2",
       "transport": {
         "type": "stdio"
       }

package/src/tests/README.md

@@ -1,83 +0,0 @@
-# Tests for Mobile Agent
-
-This directory contains unit tests for the Mobile Agent project.
-
-## Running Tests
-
-To run all tests:
-
-```bash
-npm test
-```
-
-To run specific test files:
-
-```bash
-# Run tests for the locator generation functionality
-npm run test:locators
-```
-
-## Test Files
-
-### generate-all-locators.test.ts
-
-This file contains tests for the `generateAllElementLocators` function, which is responsible for generating locators for all elements in a page source XML.
-
-The tests cover:
-
-1. Basic functionality with valid XML
-2. Handling of invalid/empty XML
-3. Various filtering options:
-   - `includeTagNames` - Include only specific element types
-   - `excludeTagNames` - Exclude specific element types
-   - `minAttributeCount` - Filter elements by minimum attribute count
-   - `fetchableOnly` - Include only interactable elements (platform-specific)
-   - `clickableOnly` - Include only clickable elements
-
-## Adding New Tests
-
-When adding new tests:
-
-1. Create a new test file in the `src/tests` directory with the `.test.ts` extension
-2. Import the necessary functions and types from the source files
-3. Use Jest's `describe`, `test`, and `expect` functions to structure your tests
-4. Add a new script to `package.json` for running your specific test file
-
-## Test Structure
-
-Tests should follow this general structure:
-
-```typescript
-import { describe, test, expect } from '@jest/globals';
-import { functionToTest } from '../path/to/function.js';
-
-describe('functionToTest', () => {
-  test('should do something specific', () => {
-    // Arrange - set up test data
-    const input = 'some input';
-    
-    // Act - call the function
-    const result = functionToTest(input);
-    
-    // Assert - verify the result
-    expect(result).toBe('expected output');
-  });
-});
-```
-
-## Mocking
-
-For tests that require mocking dependencies, use Jest's mocking capabilities:
-
-```typescript
-import { jest } from '@jest/globals';
-
-// Mock a module
-jest.mock('../path/to/module.js');
-
-// Create a mock function
-const mockFunction = jest.fn();
-mockFunction.mockReturnValue('mocked value');
-```
-
-Note that when working with ESM modules, you may need to use different mocking approaches than with CommonJS modules.

package/src/tests/__mocks__/@appium/support.ts

@@ -1,73 +0,0 @@
-// Mock @appium/support for Jest tests
-// This avoids the ESM/CommonJS mismatch with uuid dependency
-
-export const logger = {
-  getLogger: (_name: string) =>
-    // Simple logger implementation for tests
-    // No-op functions that match the logger interface
-    ({
-      debug: (_message: string, ..._args: any[]) => {
-        // Silent in tests by default
-      },
-      info: (_message: string, ..._args: any[]) => {
-        // Silent in tests by default
-      },
-      warn: (_message: string, ..._args: any[]) => {
-        // Silent in tests by default
-      },
-      error: (_message: string, ..._args: any[]) => {
-        // Silent in tests by default
-      },
-      trace: (_message: string, ..._args: any[]) => {
-        // Silent in tests by default
-      },
-    }),
-};
-
-/**
- * Mock imageUtil for Jest tests.
- *
- * A single shared sharpInstance is used across all calls so tests can
- * inspect and override its methods (resize / jpeg / toBuffer) via
- * mockSharpInstance exported below.
- */
-
-export type MockSharpInstance = {
-  resizeCalls: Array<[number, number]>;
-  toBufferImpl: () => Promise<Buffer>;
-  resize: (w: number, h: number) => MockSharpInstance;
-  jpeg: (_opts?: unknown) => MockSharpInstance;
-  toBuffer: () => Promise<Buffer>;
-  reset: () => void;
-};
-
-/** Shared instance – tests can mutate toBufferImpl or inspect resizeCalls */
-export const mockSharpInstance: MockSharpInstance = {
-  resizeCalls: [],
-  toBufferImpl: () => Promise.resolve(Buffer.from('mock-compressed-image')),
-  resize(w: number, h: number) {
-    this.resizeCalls.push([w, h]);
-    return this;
-  },
-  jpeg(_opts?: unknown) {
-    return this;
-  },
-  toBuffer() {
-    return this.toBufferImpl();
-  },
-  reset() {
-    this.resizeCalls = [];
-    this.toBufferImpl = () =>
-      Promise.resolve(Buffer.from('mock-compressed-image'));
-  },
-};
-
-export const imageUtil = {
-  requireSharp: () => (_input: Buffer) => mockSharpInstance,
-};
-
-// Export other commonly used utilities from @appium/support if needed
-export default {
-  logger,
-  imageUtil,
-};

package/src/tests/benchmark_model/TEST_REPORT.md

@@ -1,331 +0,0 @@
-# Model Benchmark Test Report
-
-**Test Date:** 2026/2/26 17:38:15
-**Test Type:** Automation Testing - Click Action Recognition
-
----
-
-## Summary
-
-| Model Name | Duration(ms) | Status | Accuracy Score | Annotated Image |
-|------------|--------------|--------|----------------|-----------------|
-| qwen3-vl-plus | 12649 | ✅ Success | 100% | [View](output/qwen3_vl_plus_annotated.png) |
-| qwen3-vl-8b-instruct | 10809 | ✅ Success | 100% | [View](output/qwen3_vl_8b_instruct_annotated.png) |
-| Qwen3-VL-235B-A22B-Instruct | 8417 | ✅ Success | 100% | [View](output/Qwen3_VL_235B_A22B_Instruct_annotated.png) |
-| doubao-seed-2-0-pro-260215 | 24796 | ✅ Success | 100% | [View](output/doubao_seed_2_0_pro_260215_annotated.png) |
-| gemini-3-flash-preview | 17353 | ✅ Success | 100% | [View](output/gemini_3_flash_preview_annotated.png) |
-| gemini-3-pro-preview | 51574 | ✅ Success | 100% | [View](output/gemini_3_pro_preview_annotated.png) |
-| gemini-2.5-pro | 28762 | ✅ Success | 100% | [View](output/gemini_2_5_pro_annotated.png) |
-| gemini-2.5-flash | 17583 | ✅ Success | 100% | [View](output/gemini_2_5_flash_annotated.png) |
-| gpt-5.2 | 18461 | ✅ Success | 95% | [View](output/gpt_5_2_annotated.png) |
-| gpt-5.2-pro | 43517 | ✅ Success | 75% | [View](output/gpt_5_2_pro_annotated.png) |
-| kimi-k2.5 | 13021 | ✅ Success | 45% | [View](output/kimi_k2_5_annotated.png) |
-| gpt-5.1 | 18604 | ✅ Success | 45% | [View](output/gpt_5_1_annotated.png) |
-| gpt-5-nano | 25101 | ✅ Success | 20% | [View](output/gpt_5_nano_annotated.png) |
-| DeepSeek-V3.2 | 10187 | ✅ Success | 0% | [View](output/DeepSeek_V3_2_annotated.png) |
-| claude-sonnet-4-6 | 68981 | ✅ Success | 0% | [View](output/claude_sonnet_4_6_annotated.png) |
-| grok-4.1-fast | 16239 | ✅ Success | 0% | [View](output/grok_4_1_fast_annotated.png) |
-
-### Statistics
-
-- **Total**: 18 models
-- **Success**: 16 (88.9%)
-- **Failed**: 2
-- **High Accuracy (≥70%)**: 10 (55.6%)
-- **Avg Accuracy Score**: 60.0%
-- **Average Duration**: 31332.22ms
-- **Min Duration**: 8417ms
-- **Max Duration**: 120021ms
-
----
-
-## Detailed Results
-
-
-============================================================
-## DeepSeek-V3.2
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## qwen3-vl-plus
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## qwen3-vl-8b-instruct
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## Qwen3-VL-235B-A22B-Instruct
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## doubao-seed-2-0-pro-260215
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## kimi-k2.5
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## gpt-5.2-pro
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## gpt-5.2
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## gpt-5.1
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## gpt-5-nano
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## claude-sonnet-4-6
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## gemini-3-flash-preview
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## gemini-3-pro-preview
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## gemini-2.5-pro
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## gemini-2.5-flash
-
-**Started at:** 2026/2/26 17:38:15
-
-
-============================================================
-## grok-4.1-fast
-
-**Started at:** 2026/2/26 17:38:15
-
-
-**BBox:** [45, 526, 958, 579]
-**Target:** 搜索酒店
-**Annotated Image:** [Qwen3_VL_235B_A22B_Instruct_annotated.png](output/Qwen3_VL_235B_A22B_Instruct_annotated.png)
-**BBox:** [135, 2150, 1035, 2270]
-**Target:** 搜索酒店
-**Annotated Image:** [DeepSeek_V3_2_annotated.png](output/DeepSeek_V3_2_annotated.png)
-**BBox:** [46, 527, 963, 580]
-**Target:** 搜索酒店
-**Annotated Image:** [qwen3_vl_8b_instruct_annotated.png](output/qwen3_vl_8b_instruct_annotated.png)
-**BBox:** [42, 526, 958, 578]
-**Target:** 搜索酒店
-**Annotated Image:** [qwen3_vl_plus_annotated.png](output/qwen3_vl_plus_annotated.png)
-**BBox:** [50, 1120, 1120, 1220]
-**Target:** 搜索酒店
-**Annotated Image:** [kimi_k2_5_annotated.png](output/kimi_k2_5_annotated.png)
-**Accuracy Score:** 100%
-**Status:** ✅ Success
-**Duration:** 8417ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [45, 526, 958, 579]}
-```
-
-**Accuracy Score:** 0%
-**Status:** ✅ Success
-**Duration:** 10187ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [135, 2150, 1035, 2270]}
-```
-
-**BBox:** [150, 2100, 1020, 2280]
-**Target:** 搜索酒店
-**Annotated Image:** [grok_4_1_fast_annotated.png](output/grok_4_1_fast_annotated.png)
-**Accuracy Score:** 100%
-**Status:** ✅ Success
-**Duration:** 10809ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [46, 527, 963, 580]}
-```
-
-**BBox:** [44, 1323, 1126, 1471]
-**Target:** 搜索酒店
-**Annotated Image:** [gemini_3_flash_preview_annotated.png](output/gemini_3_flash_preview_annotated.png)
-**BBox:** [58, 528, 1112, 598]
-**Target:** 搜索酒店
-**Annotated Image:** [gemini_2_5_flash_annotated.png](output/gemini_2_5_flash_annotated.png)
-**BBox:** [89, 1408, 1080, 1563]
-**Target:** 搜索酒店
-**Annotated Image:** [gpt_5_2_annotated.png](output/gpt_5_2_annotated.png)
-**BBox:** [119, 921, 1051, 1096]
-**Target:** 搜索酒店
-**Annotated Image:** [gpt_5_1_annotated.png](output/gpt_5_1_annotated.png)
-**Accuracy Score:** 100%
-**Status:** ✅ Success
-**Duration:** 12649ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [42, 526, 958, 578]}
-```
-
-**Accuracy Score:** 45%
-**Status:** ✅ Success
-**Duration:** 13021ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [50, 1120, 1120, 1220]}
-```
-
-**Accuracy Score:** 0%
-**Status:** ✅ Success
-**Duration:** 16239ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [150, 2100, 1020, 2280]}
-```
-
-**Accuracy Score:** 100%
-**Status:** ✅ Success
-**Duration:** 17583ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [58, 528, 1112, 598]}
-```
-
-**Accuracy Score:** 100%
-**Status:** ✅ Success
-**Duration:** 17353ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [44, 1323, 1126, 1471]}
-```
-
-**Accuracy Score:** 95%
-**Status:** ✅ Success
-**Duration:** 18461ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [89, 1408, 1080, 1563]}
-```
-
-**Accuracy Score:** 45%
-**Status:** ✅ Success
-**Duration:** 18604ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [119, 921, 1051, 1096]}
-```
-
-**BBox:** [38, 525, 1132, 579]
-**Target:** 搜索酒店
-**Annotated Image:** [doubao_seed_2_0_pro_260215_annotated.png](output/doubao_seed_2_0_pro_260215_annotated.png)
-**BBox:** [60, 1500, 1110, 1690]
-**Target:** 搜索酒店
-**Annotated Image:** [gpt_5_nano_annotated.png](output/gpt_5_nano_annotated.png)
-**BBox:** [48, 535, 1122, 638]
-**Target:** 搜索酒店
-**Annotated Image:** [gemini_2_5_pro_annotated.png](output/gemini_2_5_pro_annotated.png)
-**Accuracy Score:** 100%
-**Status:** ✅ Success
-**Duration:** 24796ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [38, 525, 1132, 579]}
-```
-
-**Accuracy Score:** 20%
-**Status:** ✅ Success
-**Duration:** 25101ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [60, 1500, 1110, 1690]}
-```
-
-**Accuracy Score:** 100%
-**Status:** ✅ Success
-**Duration:** 28762ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [48, 535, 1122, 638]}
-```
-
-**BBox:** [112, 1412, 1058, 1565]
-**Target:** 搜索酒店
-**Annotated Image:** [gpt_5_2_pro_annotated.png](output/gpt_5_2_pro_annotated.png)
-**Accuracy Score:** 75%
-**Status:** ✅ Success
-**Duration:** 43517ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [112, 1412, 1058, 1565]}
-```
-
-**BBox:** [42, 1328, 1128, 1468]
-**Target:** 搜索酒店
-**Annotated Image:** [gemini_3_pro_preview_annotated.png](output/gemini_3_pro_preview_annotated.png)
-**Accuracy Score:** 100%
-**Status:** ✅ Success
-**Duration:** 51574ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [42, 1328, 1128, 1468]}
-```
-
-**BBox:** [33, 835, 693, 900]
-**Target:** 搜索酒店
-**Annotated Image:** [claude_sonnet_4_6_annotated.png](output/claude_sonnet_4_6_annotated.png)
-**Accuracy Score:** 0%
-**Status:** ✅ Success
-**Duration:** 68981ms
-**Response:**
-```
-action: **CLICK**
-Parameters: {"target": "搜索酒店", "bbox_2d": [33, 835, 693, 900]}
-```