@us-all/android-mcp 1.0.0

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.
Files changed (51) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +277 -0
  3. package/dist/adb.d.ts +8 -0
  4. package/dist/adb.d.ts.map +1 -0
  5. package/dist/adb.js +35 -0
  6. package/dist/adb.js.map +1 -0
  7. package/dist/config.d.ts +9 -0
  8. package/dist/config.d.ts.map +1 -0
  9. package/dist/config.js +22 -0
  10. package/dist/config.js.map +1 -0
  11. package/dist/index.d.ts +3 -0
  12. package/dist/index.d.ts.map +1 -0
  13. package/dist/index.js +81 -0
  14. package/dist/index.js.map +1 -0
  15. package/dist/tools/apps.d.ts +51 -0
  16. package/dist/tools/apps.d.ts.map +1 -0
  17. package/dist/tools/apps.js +174 -0
  18. package/dist/tools/apps.js.map +1 -0
  19. package/dist/tools/device.d.ts +44 -0
  20. package/dist/tools/device.d.ts.map +1 -0
  21. package/dist/tools/device.js +105 -0
  22. package/dist/tools/device.js.map +1 -0
  23. package/dist/tools/emulator.d.ts +46 -0
  24. package/dist/tools/emulator.d.ts.map +1 -0
  25. package/dist/tools/emulator.js +129 -0
  26. package/dist/tools/emulator.js.map +1 -0
  27. package/dist/tools/files.d.ts +36 -0
  28. package/dist/tools/files.d.ts.map +1 -0
  29. package/dist/tools/files.js +85 -0
  30. package/dist/tools/files.js.map +1 -0
  31. package/dist/tools/logcat.d.ts +44 -0
  32. package/dist/tools/logcat.d.ts.map +1 -0
  33. package/dist/tools/logcat.js +123 -0
  34. package/dist/tools/logcat.js.map +1 -0
  35. package/dist/tools/shell.d.ts +11 -0
  36. package/dist/tools/shell.d.ts.map +1 -0
  37. package/dist/tools/shell.js +34 -0
  38. package/dist/tools/shell.js.map +1 -0
  39. package/dist/tools/system.d.ts +31 -0
  40. package/dist/tools/system.d.ts.map +1 -0
  41. package/dist/tools/system.js +80 -0
  42. package/dist/tools/system.js.map +1 -0
  43. package/dist/tools/ui.d.ts +80 -0
  44. package/dist/tools/ui.d.ts.map +1 -0
  45. package/dist/tools/ui.js +195 -0
  46. package/dist/tools/ui.js.map +1 -0
  47. package/dist/tools/utils.d.ts +43 -0
  48. package/dist/tools/utils.d.ts.map +1 -0
  49. package/dist/tools/utils.js +108 -0
  50. package/dist/tools/utils.js.map +1 -0
  51. package/package.json +56 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/tools/ui.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ export declare class WriteBlockedError extends Error {
2
+ constructor();
3
+ }
4
+ export declare class ShellBlockedError extends Error {
5
+ constructor();
6
+ }
7
+ export declare function assertWriteAllowed(): void;
8
+ export declare function assertShellAllowed(): void;
9
+ export declare function wrapToolHandler<T>(fn: (params: T) => Promise<unknown>): (params: T) => Promise<{
10
+ content: {
11
+ type: "text";
12
+ text: string;
13
+ }[];
14
+ isError?: undefined;
15
+ } | {
16
+ content: {
17
+ type: "text";
18
+ text: string;
19
+ }[];
20
+ isError: boolean;
21
+ }>;
22
+ export declare function wrapImageToolHandler<T>(fn: (params: T) => Promise<{
23
+ base64: string;
24
+ mimeType: string;
25
+ metadata?: unknown;
26
+ }>): (params: T) => Promise<{
27
+ content: ({
28
+ type: "text";
29
+ text: string;
30
+ } | {
31
+ type: "image";
32
+ data: string;
33
+ mimeType: string;
34
+ })[];
35
+ isError?: undefined;
36
+ } | {
37
+ content: {
38
+ type: "text";
39
+ text: string;
40
+ }[];
41
+ isError: boolean;
42
+ }>;
43
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAmBA,qBAAa,iBAAkB,SAAQ,KAAK;;CAO3C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;;CAO3C;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IACtD,QAAQ,CAAC;;;;;;;;;;;;GA2CxB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,IAEtE,QAAQ,CAAC;;cAGU,MAAM;cAAQ,MAAM;;cAAa,OAAO;cAAQ,MAAM;kBAAY,MAAM;;;;;;;;;GAuB1G"}
@@ -0,0 +1,108 @@
1
+ import { config } from "../config.js";
2
+ const SENSITIVE_PATTERNS = [
3
+ /api[_-]?key/gi,
4
+ /secret/gi,
5
+ /password/gi,
6
+ /token/gi,
7
+ /bearer\s+\S+/gi,
8
+ /authorization/gi,
9
+ ];
10
+ function sanitize(text) {
11
+ let result = text;
12
+ for (const pattern of SENSITIVE_PATTERNS) {
13
+ result = result.replace(pattern, "[REDACTED]");
14
+ }
15
+ return result;
16
+ }
17
+ export class WriteBlockedError extends Error {
18
+ constructor() {
19
+ super("Write operations are disabled. Set ANDROID_MCP_ALLOW_WRITE=true to enable.");
20
+ this.name = "WriteBlockedError";
21
+ }
22
+ }
23
+ export class ShellBlockedError extends Error {
24
+ constructor() {
25
+ super("Shell command execution is disabled. Set ANDROID_MCP_ALLOW_SHELL=true to enable.");
26
+ this.name = "ShellBlockedError";
27
+ }
28
+ }
29
+ export function assertWriteAllowed() {
30
+ if (!config.allowWrite) {
31
+ throw new WriteBlockedError();
32
+ }
33
+ }
34
+ export function assertShellAllowed() {
35
+ if (!config.allowShell) {
36
+ throw new ShellBlockedError();
37
+ }
38
+ }
39
+ export function wrapToolHandler(fn) {
40
+ return async (params) => {
41
+ try {
42
+ const result = await fn(params);
43
+ return {
44
+ content: [
45
+ { type: "text", text: JSON.stringify(result, null, 2) },
46
+ ],
47
+ };
48
+ }
49
+ catch (error) {
50
+ if (error instanceof WriteBlockedError || error instanceof ShellBlockedError) {
51
+ return {
52
+ content: [{ type: "text", text: error.message }],
53
+ isError: true,
54
+ };
55
+ }
56
+ const structured = {
57
+ message: "Unknown error",
58
+ };
59
+ if (error instanceof Error) {
60
+ structured.message = sanitize(error.message);
61
+ if ("code" in error && typeof error.code === "number") {
62
+ structured.exitCode = error.code;
63
+ }
64
+ if ("stderr" in error && typeof error.stderr === "string") {
65
+ structured.stderr = sanitize(error.stderr);
66
+ }
67
+ }
68
+ else {
69
+ structured.message = sanitize(String(error));
70
+ }
71
+ return {
72
+ content: [
73
+ { type: "text", text: JSON.stringify(structured, null, 2) },
74
+ ],
75
+ isError: true,
76
+ };
77
+ }
78
+ };
79
+ }
80
+ export function wrapImageToolHandler(fn) {
81
+ return async (params) => {
82
+ try {
83
+ const result = await fn(params);
84
+ const content = [
85
+ {
86
+ type: "image",
87
+ data: result.base64,
88
+ mimeType: result.mimeType,
89
+ },
90
+ ];
91
+ if (result.metadata) {
92
+ content.push({
93
+ type: "text",
94
+ text: JSON.stringify(result.metadata, null, 2),
95
+ });
96
+ }
97
+ return { content };
98
+ }
99
+ catch (error) {
100
+ const message = error instanceof Error ? sanitize(error.message) : sanitize(String(error));
101
+ return {
102
+ content: [{ type: "text", text: message }],
103
+ isError: true,
104
+ };
105
+ }
106
+ };
107
+ }
108
+ //# sourceMappingURL=utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,56 @@
1
+ {
2
+ "name": "@us-all/android-mcp",
3
+ "version": "1.0.0",
4
+ "description": "Android MCP server - ADB-based device management, UI automation, logcat, emulator control, and more",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "bin": {
8
+ "android-mcp": "dist/index.js"
9
+ },
10
+ "files": [
11
+ "dist",
12
+ "README.md",
13
+ "LICENSE"
14
+ ],
15
+ "engines": {
16
+ "node": ">=20.0.0"
17
+ },
18
+ "packageManager": "pnpm@10.30.2",
19
+ "scripts": {
20
+ "build": "tsc",
21
+ "dev": "tsc --watch",
22
+ "start": "node dist/index.js",
23
+ "test": "vitest run",
24
+ "test:watch": "vitest",
25
+ "presmoke": "pnpm run build",
26
+ "smoke": "node scripts/smoke-test.mjs"
27
+ },
28
+ "dependencies": {
29
+ "@modelcontextprotocol/sdk": "^1.27.1",
30
+ "dotenv": "^17.3.1",
31
+ "fast-xml-parser": "^5.2.3",
32
+ "zod": "^4.3.6"
33
+ },
34
+ "devDependencies": {
35
+ "@types/node": "^22.15.0",
36
+ "typescript": "^5.9.3",
37
+ "vitest": "^4.1.1"
38
+ },
39
+ "keywords": [
40
+ "mcp",
41
+ "android",
42
+ "adb",
43
+ "model-context-protocol",
44
+ "claude",
45
+ "automation"
46
+ ],
47
+ "license": "MIT",
48
+ "repository": {
49
+ "type": "git",
50
+ "url": "https://github.com/us-all/android-mcp-server.git"
51
+ },
52
+ "homepage": "https://github.com/us-all/android-mcp-server#readme",
53
+ "bugs": {
54
+ "url": "https://github.com/us-all/android-mcp-server/issues"
55
+ }
56
+ }