appium-mcp 1.94.1 → 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 +12 -0
- package/README.md +2 -0
- package/dist/tools/interactions/press-key.d.ts.map +1 -1
- package/dist/tools/interactions/press-key.js +4 -2
- package/dist/tools/interactions/press-key.js.map +1 -1
- package/dist/tools/interactions/screen-recording.d.ts +1 -3
- package/dist/tools/interactions/screen-recording.d.ts.map +1 -1
- package/dist/tools/interactions/screen-recording.js +10 -5
- package/dist/tools/interactions/screen-recording.js.map +1 -1
- package/package.json +1 -1
- package/server.json +2 -2
- package/src/tools/interactions/press-key.ts +4 -2
- package/src/tools/interactions/screen-recording.ts +14 -8
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,15 @@
|
|
|
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
|
+
|
|
7
|
+
## [1.94.2](https://github.com/appium/appium-mcp/compare/v1.94.1...v1.94.2) (2026-09-19)
|
|
8
|
+
|
|
9
|
+
### Bug Fixes
|
|
10
|
+
|
|
11
|
+
* restrict screen recording scaling options ([#535](https://github.com/appium/appium-mcp/issues/535)) ([5302858](https://github.com/appium/appium-mcp/commit/53028586f5ea31d8d4b26c98b3fb5634e2199c37))
|
|
12
|
+
|
|
1
13
|
## [1.94.1](https://github.com/appium/appium-mcp/compare/v1.94.0...v1.94.1) (2026-09-18)
|
|
2
14
|
|
|
3
15
|
### Bug Fixes
|
package/README.md
CHANGED
|
@@ -277,6 +277,8 @@ Screen recordings are saved as MP4 files to the same directory as screenshots (`
|
|
|
277
277
|
|
|
278
278
|
To start recording, call `appium_screen_recording` with `action="start"`. You may provide `timeLimit` in seconds to limit the maximum recording duration, but the start call still returns immediately. To finalize the recording, save the video, and receive the file path, call `appium_screen_recording` again with `action="stop"`.
|
|
279
279
|
|
|
280
|
+
For iOS, `videoScale` accepts `width:height` with dimensions from 1 to 16384 (for example, `1280:720`). One dimension may be `-1` or `-2` to preserve the aspect ratio; `-2` also makes that dimension divisible by two. Scaling expressions and custom `videoFilters` are no longer supported by this MCP tool.
|
|
281
|
+
|
|
280
282
|
### AI Vision Element Finding
|
|
281
283
|
|
|
282
284
|
Configure AI-powered element finding using vision models. When enabled, a separate tool — **`appium_ai`** — is registered alongside `appium_find_element`. It exposes `action=find_element`, which locates UI elements from natural-language descriptions and returns a coordinate UUID (`ai-element:x,y:bbox`) that can be passed to `appium_gesture` (`tap` / `double_tap` / `long_press`).
|
|
@@ -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,
|
|
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
|
-
|
|
93
|
-
|
|
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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"}
|
|
@@ -10,9 +10,7 @@ export interface IOSRecordingOptions {
|
|
|
10
10
|
videoQuality?: 'low' | 'medium' | 'high' | 'photo' | number;
|
|
11
11
|
/** Frames per second. Default: 10. */
|
|
12
12
|
videoFps?: number;
|
|
13
|
-
/**
|
|
14
|
-
videoFilters?: string;
|
|
15
|
-
/** Scaling value (e.g. 1280:720). Ignored if videoFilters is set. @see https://trac.ffmpeg.org/wiki/Scaling */
|
|
13
|
+
/** Width:height, each 1–16384; one dimension may be -1 or -2 to preserve the aspect ratio. */
|
|
16
14
|
videoScale?: string;
|
|
17
15
|
/** Output pixel format. Run `ffmpeg -pix_fmts` for options. Use yuv420p with videoType=libx264 for QuickTime compatibility. */
|
|
18
16
|
pixelFormat?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"screen-recording.d.ts","sourceRoot":"","sources":["../../../src/tools/interactions/screen-recording.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,OAAO,EAAC,MAAM,SAAS,CAAC;AAQpD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,YAAY,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5D,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,
|
|
1
|
+
{"version":3,"file":"screen-recording.d.ts","sourceRoot":"","sources":["../../../src/tools/interactions/screen-recording.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,OAAO,EAAC,MAAM,SAAS,CAAC;AAQpD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,YAAY,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5D,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+HAA+H;IAC/H,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC;CAC/E;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0GAA0G;IAC1G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAoDD,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAuF7D"}
|
|
@@ -29,8 +29,16 @@ const screenRecordingSchema = z.object({
|
|
|
29
29
|
.describe('iOS only. Video quality preset. Default: medium.'),
|
|
30
30
|
videoFps: z.number().int().min(1).max(60).optional().describe('iOS only. Frames per second. Default: 10.'),
|
|
31
31
|
videoType: z.string().optional().describe('iOS only. Video codec to use (e.g. libx264).'),
|
|
32
|
-
|
|
33
|
-
videoScale: z
|
|
32
|
+
// XCUITest embeds this value in an FFmpeg filtergraph. Accept dimensions only.
|
|
33
|
+
videoScale: z
|
|
34
|
+
.string()
|
|
35
|
+
.regex(/^(?:[1-9]\d{0,4}|-[12]):(?:[1-9]\d{0,4}|-[12])(?![\s\S])/, 'Use width:height (e.g. 1280:720 or -2:720), without filter expressions.')
|
|
36
|
+
.refine((value) => {
|
|
37
|
+
const dimensions = value.split(':').map(Number);
|
|
38
|
+
return dimensions.every((dimension) => dimension <= 16384) && dimensions.some((dimension) => dimension > 0);
|
|
39
|
+
}, 'Dimensions must be 1–16384; only one dimension may be -1 or -2.')
|
|
40
|
+
.optional()
|
|
41
|
+
.describe('iOS only. Width:height, each 1–16384 (e.g. 1280:720); one may be -1 or -2 to preserve aspect ratio.'),
|
|
34
42
|
pixelFormat: z.string().optional().describe('iOS only. Output pixel format (e.g. yuv420p).'),
|
|
35
43
|
hardwareAcceleration: z
|
|
36
44
|
.enum(['videoToolbox', 'cuda', 'amf_dx11', 'qsv', 'vaapi'])
|
|
@@ -86,9 +94,6 @@ export default function screenRecording(server) {
|
|
|
86
94
|
}
|
|
87
95
|
iosOptions.videoType = args.videoType ?? 'libx264';
|
|
88
96
|
iosOptions.pixelFormat = args.pixelFormat ?? 'yuv420p';
|
|
89
|
-
if (args.videoFilters !== undefined) {
|
|
90
|
-
iosOptions.videoFilters = args.videoFilters;
|
|
91
|
-
}
|
|
92
97
|
if (args.videoScale !== undefined) {
|
|
93
98
|
iosOptions.videoScale = args.videoScale;
|
|
94
99
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"screen-recording.js","sourceRoot":"","sources":["../../../src/tools/interactions/screen-recording.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B,OAAO,EAAC,EAAE,EAAC,MAAM,iBAAiB,CAAC;AAEnC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,oBAAoB,IAAI,iBAAiB,EAAE,mBAAmB,IAAI,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AACpH,OAAO,EAAC,eAAe,EAAE,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAC,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"screen-recording.js","sourceRoot":"","sources":["../../../src/tools/interactions/screen-recording.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.
|
|
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.
|
|
6
|
+
"version": "1.94.3",
|
|
7
7
|
"packages": [
|
|
8
8
|
{
|
|
9
9
|
"registryType": "npm",
|
|
10
10
|
"identifier": "appium-mcp",
|
|
11
|
-
"version": "1.94.
|
|
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
|
-
|
|
119
|
-
|
|
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}.`);
|
|
@@ -21,9 +21,7 @@ export interface IOSRecordingOptions {
|
|
|
21
21
|
videoQuality?: 'low' | 'medium' | 'high' | 'photo' | number;
|
|
22
22
|
/** Frames per second. Default: 10. */
|
|
23
23
|
videoFps?: number;
|
|
24
|
-
/**
|
|
25
|
-
videoFilters?: string;
|
|
26
|
-
/** Scaling value (e.g. 1280:720). Ignored if videoFilters is set. @see https://trac.ffmpeg.org/wiki/Scaling */
|
|
24
|
+
/** Width:height, each 1–16384; one dimension may be -1 or -2 to preserve the aspect ratio. */
|
|
27
25
|
videoScale?: string;
|
|
28
26
|
/** Output pixel format. Run `ffmpeg -pix_fmts` for options. Use yuv420p with videoType=libx264 for QuickTime compatibility. */
|
|
29
27
|
pixelFormat?: string;
|
|
@@ -78,8 +76,19 @@ const screenRecordingSchema = z.object({
|
|
|
78
76
|
.describe('iOS only. Video quality preset. Default: medium.'),
|
|
79
77
|
videoFps: z.number().int().min(1).max(60).optional().describe('iOS only. Frames per second. Default: 10.'),
|
|
80
78
|
videoType: z.string().optional().describe('iOS only. Video codec to use (e.g. libx264).'),
|
|
81
|
-
|
|
82
|
-
videoScale: z
|
|
79
|
+
// XCUITest embeds this value in an FFmpeg filtergraph. Accept dimensions only.
|
|
80
|
+
videoScale: z
|
|
81
|
+
.string()
|
|
82
|
+
.regex(
|
|
83
|
+
/^(?:[1-9]\d{0,4}|-[12]):(?:[1-9]\d{0,4}|-[12])(?![\s\S])/,
|
|
84
|
+
'Use width:height (e.g. 1280:720 or -2:720), without filter expressions.',
|
|
85
|
+
)
|
|
86
|
+
.refine((value) => {
|
|
87
|
+
const dimensions = value.split(':').map(Number);
|
|
88
|
+
return dimensions.every((dimension) => dimension <= 16384) && dimensions.some((dimension) => dimension > 0);
|
|
89
|
+
}, 'Dimensions must be 1–16384; only one dimension may be -1 or -2.')
|
|
90
|
+
.optional()
|
|
91
|
+
.describe('iOS only. Width:height, each 1–16384 (e.g. 1280:720); one may be -1 or -2 to preserve aspect ratio.'),
|
|
83
92
|
pixelFormat: z.string().optional().describe('iOS only. Output pixel format (e.g. yuv420p).'),
|
|
84
93
|
hardwareAcceleration: z
|
|
85
94
|
.enum(['videoToolbox', 'cuda', 'amf_dx11', 'qsv', 'vaapi'])
|
|
@@ -144,9 +153,6 @@ export default function screenRecording(server: FastMCP): void {
|
|
|
144
153
|
}
|
|
145
154
|
iosOptions.videoType = args.videoType ?? 'libx264';
|
|
146
155
|
iosOptions.pixelFormat = args.pixelFormat ?? 'yuv420p';
|
|
147
|
-
if (args.videoFilters !== undefined) {
|
|
148
|
-
iosOptions.videoFilters = args.videoFilters;
|
|
149
|
-
}
|
|
150
156
|
if (args.videoScale !== undefined) {
|
|
151
157
|
iosOptions.videoScale = args.videoScale;
|
|
152
158
|
}
|