appium-mcp 1.72.3 → 1.72.4
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 +6 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +15 -2
- package/dist/server.js.map +1 -1
- package/package.json +1 -1
- package/server.json +2 -2
- package/src/resources/submodules.zip +0 -0
- package/src/server.ts +17 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,9 @@
|
|
|
1
|
+
## [1.72.4](https://github.com/appium/appium-mcp/compare/v1.72.3...v1.72.4) (2026-05-02)
|
|
2
|
+
|
|
3
|
+
### Miscellaneous Chores
|
|
4
|
+
|
|
5
|
+
* **server:** expand MCP instructions and sync FastMCP version ([#313](https://github.com/appium/appium-mcp/issues/313)) ([5bec5df](https://github.com/appium/appium-mcp/commit/5bec5df45deb8e157a0b534f22788ee2cdffe946))
|
|
6
|
+
|
|
1
7
|
## [1.72.3](https://github.com/appium/appium-mcp/compare/v1.72.2...v1.72.3) (2026-05-02)
|
|
2
8
|
|
|
3
9
|
### Bug Fixes
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAyClC,QAAA,MAAM,MAAM,+CAIV,CAAC;AA2CH,eAAe,MAAM,CAAC"}
|
package/dist/server.js
CHANGED
|
@@ -1,8 +1,21 @@
|
|
|
1
1
|
import { FastMCP } from 'fastmcp';
|
|
2
|
+
import pkg from '../package.json' with { type: 'json' };
|
|
2
3
|
import registerTools from './tools/index.js';
|
|
3
4
|
import registerResources from './resources/index.js';
|
|
4
5
|
import { listSessions, safeDeleteAllSessions } from './session-store.js';
|
|
5
6
|
import log from './logger.js';
|
|
7
|
+
// FastMCP types `version` as a literal `${number}.${number}.${number}` template,
|
|
8
|
+
// while `package.json.version` is just `string`. The cast is the supported
|
|
9
|
+
// escape hatch for projects that want the published version to flow through.
|
|
10
|
+
const SERVER_VERSION = pkg.version;
|
|
11
|
+
const SERVER_INSTRUCTIONS = [
|
|
12
|
+
'Appium mobile automation through MCP. Defaults that avoid broken flows:',
|
|
13
|
+
'- Establish a driver session first: select_device and appium_session_management (action=create) for local/embedded mode, or attach to a remote session when the user supplies a server URL.',
|
|
14
|
+
'- Call only tools this server actually registers (appium_find_element, appium_gesture, appium_session_management, etc.); do not invent tool names or aliases.',
|
|
15
|
+
'- Prefer stable locators: accessibility id and id before long xpath; use xpath only when nothing else works.',
|
|
16
|
+
'- Use appium_gesture for taps and drags; when something is off-screen, use action=scroll_to_element instead of spamming appium_find_element alone.',
|
|
17
|
+
'- For local Appium install, doctor, or smoke tests, run appium_skills before guessing commands.',
|
|
18
|
+
].join('\n');
|
|
6
19
|
/**
|
|
7
20
|
* MCP disconnect policy for Appium sessions tracked by this server.
|
|
8
21
|
* - delete_all (default): end every owned session when the MCP client disconnects (avoids leaked drivers).
|
|
@@ -20,8 +33,8 @@ function disconnectSessionPolicyFromEnv() {
|
|
|
20
33
|
}
|
|
21
34
|
const server = new FastMCP({
|
|
22
35
|
name: 'MCP Appium',
|
|
23
|
-
version:
|
|
24
|
-
instructions:
|
|
36
|
+
version: SERVER_VERSION,
|
|
37
|
+
instructions: SERVER_INSTRUCTIONS,
|
|
25
38
|
});
|
|
26
39
|
registerResources(server);
|
|
27
40
|
registerTools(server);
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,GAAG,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxD,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,GAAG,MAAM,aAAa,CAAC;AAE9B,iFAAiF;AACjF,2EAA2E;AAC3E,6EAA6E;AAC7E,MAAM,cAAc,GAAG,GAAG,CAAC,OAA0C,CAAC;AAEtE,MAAM,mBAAmB,GAAG;IAC1B,yEAAyE;IACzE,6LAA6L;IAC7L,+JAA+J;IAC/J,8GAA8G;IAC9G,oJAAoJ;IACpJ,iGAAiG;CAClG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAIb;;;;GAIG;AACH,SAAS,8BAA8B;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9E,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CACN,oCAAoC,GAAG,6EAA6E,CACrH,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC;IACzB,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,cAAc;IACvB,YAAY,EAAE,mBAAmB;CAClC,CAAC,CAAC;AAEH,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,aAAa,CAAC,MAAM,CAAC,CAAC;AAEtB,oDAAoD;AACpD,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;IAC7B,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IACtC,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,8BAA8B,EAAE,CAAC;IAEhD,MAAM,aAAa,GAAG,YAAY,EAAE,CAAC,MAAM,CACzC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,KAAK,OAAO,CAC3C,CAAC;IAEF,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAClD,GAAG,CAAC,IAAI,CACN,GAAG,aAAa,CAAC,MAAM,kDAAkD;YACvE,wHAAwH,CAC3H,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CACN,GAAG,aAAa,CAAC,MAAM,0DAA0D,CAClF,CAAC;YACF,MAAM,YAAY,GAAG,MAAM,qBAAqB,EAAE,CAAC;YACnD,GAAG,CAAC,IAAI,CACN,GAAG,YAAY,oDAAoD,CACpE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC"}
|
package/package.json
CHANGED
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.72.
|
|
6
|
+
"version": "1.72.4",
|
|
7
7
|
"packages": [
|
|
8
8
|
{
|
|
9
9
|
"registryType": "npm",
|
|
10
10
|
"identifier": "appium-mcp",
|
|
11
|
-
"version": "1.72.
|
|
11
|
+
"version": "1.72.4",
|
|
12
12
|
"transport": {
|
|
13
13
|
"type": "stdio"
|
|
14
14
|
}
|
|
Binary file
|
package/src/server.ts
CHANGED
|
@@ -1,9 +1,24 @@
|
|
|
1
1
|
import { FastMCP } from 'fastmcp';
|
|
2
|
+
import pkg from '../package.json' with { type: 'json' };
|
|
2
3
|
import registerTools from './tools/index.js';
|
|
3
4
|
import registerResources from './resources/index.js';
|
|
4
5
|
import { listSessions, safeDeleteAllSessions } from './session-store.js';
|
|
5
6
|
import log from './logger.js';
|
|
6
7
|
|
|
8
|
+
// FastMCP types `version` as a literal `${number}.${number}.${number}` template,
|
|
9
|
+
// while `package.json.version` is just `string`. The cast is the supported
|
|
10
|
+
// escape hatch for projects that want the published version to flow through.
|
|
11
|
+
const SERVER_VERSION = pkg.version as `${number}.${number}.${number}`;
|
|
12
|
+
|
|
13
|
+
const SERVER_INSTRUCTIONS = [
|
|
14
|
+
'Appium mobile automation through MCP. Defaults that avoid broken flows:',
|
|
15
|
+
'- Establish a driver session first: select_device and appium_session_management (action=create) for local/embedded mode, or attach to a remote session when the user supplies a server URL.',
|
|
16
|
+
'- Call only tools this server actually registers (appium_find_element, appium_gesture, appium_session_management, etc.); do not invent tool names or aliases.',
|
|
17
|
+
'- Prefer stable locators: accessibility id and id before long xpath; use xpath only when nothing else works.',
|
|
18
|
+
'- Use appium_gesture for taps and drags; when something is off-screen, use action=scroll_to_element instead of spamming appium_find_element alone.',
|
|
19
|
+
'- For local Appium install, doctor, or smoke tests, run appium_skills before guessing commands.',
|
|
20
|
+
].join('\n');
|
|
21
|
+
|
|
7
22
|
type DisconnectSessionPolicy = 'delete_all' | 'skip';
|
|
8
23
|
|
|
9
24
|
/**
|
|
@@ -26,9 +41,8 @@ function disconnectSessionPolicyFromEnv(): DisconnectSessionPolicy {
|
|
|
26
41
|
|
|
27
42
|
const server = new FastMCP({
|
|
28
43
|
name: 'MCP Appium',
|
|
29
|
-
version:
|
|
30
|
-
instructions:
|
|
31
|
-
'Intelligent MCP server providing AI assistants with powerful tools and resources for Appium mobile automation. For local Appium environment setup or troubleshooting, use appium_skills before running installation, doctor, or smoke-test steps.',
|
|
44
|
+
version: SERVER_VERSION,
|
|
45
|
+
instructions: SERVER_INSTRUCTIONS,
|
|
32
46
|
});
|
|
33
47
|
|
|
34
48
|
registerResources(server);
|