appium-mcp 1.94.2 → 1.94.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,3 +1,9 @@
1
+ ## [1.94.3](https://github.com/appium/appium-mcp/compare/v1.94.2...v1.94.3) (2026-09-21)
2
+
3
+ ### Bug Fixes
4
+
5
+ * **press-key:** reject keyCode on iOS instead of pressing HOME ([#539](https://github.com/appium/appium-mcp/issues/539)) ([eff7688](https://github.com/appium/appium-mcp/commit/eff76888b0dd7ab159448f03718d6aa04070d018))
6
+
1
7
  ## [1.94.2](https://github.com/appium/appium-mcp/compare/v1.94.1...v1.94.2) (2026-09-19)
2
8
 
3
9
  ### Bug Fixes
@@ -1 +1 @@
1
- {"version":3,"file":"press-key.d.ts","sourceRoot":"","sources":["../../../src/tools/interactions/press-key.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgB,OAAO,EAAC,MAAM,SAAS,CAAC;AAkCpD,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA+GtD"}
1
+ {"version":3,"file":"press-key.d.ts","sourceRoot":"","sources":["../../../src/tools/interactions/press-key.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgB,OAAO,EAAC,MAAM,SAAS,CAAC;AAkCpD,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAiHtD"}
@@ -89,8 +89,10 @@ export default function pressKey(server) {
89
89
  }
90
90
  }
91
91
  else if (platform === PLATFORM.ios) {
92
- const logicalKey = key ?? 'HOME';
93
- const buttonName = IOS_BUTTON_MAP[logicalKey];
92
+ if (!key) {
93
+ return errorResult(`For iOS/tvOS, key is required and must be one of ${IOS_BUTTONS_DESCRIPTION}.`);
94
+ }
95
+ const buttonName = IOS_BUTTON_MAP[key];
94
96
  if (!buttonName) {
95
97
  return errorResult(`For iOS/tvOS, key must be one of ${IOS_BUTTONS_DESCRIPTION}.`);
96
98
  }
@@ -1 +1 @@
1
- {"version":3,"file":"press-key.js","sourceRoot":"","sources":["../../../src/tools/interactions/press-key.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"press-key.js","sourceRoot":"","sources":["../../../src/tools/interactions/press-key.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "appium-mcp",
3
- "version": "1.94.2",
3
+ "version": "1.94.3",
4
4
  "description": "Intelligent MCP server providing AI assistants with powerful tools and resources for Appium mobile automation",
5
5
  "bugs": {
6
6
  "url": "https://github.com/appium/appium-mcp/issues"
package/server.json CHANGED
@@ -3,12 +3,12 @@
3
3
  "name": "io.github.appium/appium-mcp",
4
4
  "title": "MCP Appium - Mobile Development and Automation Server",
5
5
  "description": "MCP server for Appium mobile automation on iOS and Android devices with test creation tools.",
6
- "version": "1.94.2",
6
+ "version": "1.94.3",
7
7
  "packages": [
8
8
  {
9
9
  "registryType": "npm",
10
10
  "identifier": "appium-mcp",
11
- "version": "1.94.2",
11
+ "version": "1.94.3",
12
12
  "transport": {
13
13
  "type": "stdio"
14
14
  }
@@ -115,8 +115,10 @@ export default function pressKey(server: FastMCP): void {
115
115
  return errorResult('Unsupported Android driver for press_key');
116
116
  }
117
117
  } else if (platform === PLATFORM.ios) {
118
- const logicalKey = key ?? 'HOME';
119
- const buttonName = IOS_BUTTON_MAP[logicalKey];
118
+ if (!key) {
119
+ return errorResult(`For iOS/tvOS, key is required and must be one of ${IOS_BUTTONS_DESCRIPTION}.`);
120
+ }
121
+ const buttonName = IOS_BUTTON_MAP[key];
120
122
 
121
123
  if (!buttonName) {
122
124
  return errorResult(`For iOS/tvOS, key must be one of ${IOS_BUTTONS_DESCRIPTION}.`);