mobile-agent-mcp 0.1.1

package/dist/mcp/tools.js

@@ -0,0 +1,152 @@
+import { formatError } from '../errors.js';
+export const MCP_TOOLS = [
+    {
+        name: 'list_devices',
+        description: 'Booted iOS sims, Android emulators, USB devices, Maestro version.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'doctor',
+        description: 'Run before a long flow. OK/WARN/FAIL on config, flows, tools.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'screenshot',
+        description: 'PNG under screenshotDir. Returns absolute path.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: { type: 'string', enum: ['ios', 'android'] },
+            },
+        },
+    },
+    {
+        name: 'run_maestro_flow',
+        description: 'Flow name or path under flowsDir. Extra env merges with config.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                flow: { type: 'string' },
+                platform: { type: 'string', enum: ['ios', 'android'] },
+                env: {
+                    type: 'object',
+                    additionalProperties: { type: 'string' },
+                },
+            },
+            required: ['flow'],
+        },
+    },
+    {
+        name: 'run_smoke_flows',
+        description: 'Runs smokeFlows from config, in order.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: { type: 'string', enum: ['ios', 'android'] },
+                env: {
+                    type: 'object',
+                    additionalProperties: { type: 'string' },
+                },
+            },
+        },
+    },
+    {
+        name: 'adb_reverse',
+        description: 'USB Android: reverse tcp ports to the host. Default 8081.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ports: {
+                    type: 'array',
+                    items: { type: 'number' },
+                },
+            },
+        },
+    },
+    {
+        name: 'open_url',
+        description: 'Deep link or URL on sim/device.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string' },
+                platform: { type: 'string', enum: ['ios', 'android'] },
+            },
+            required: ['url'],
+        },
+    },
+    {
+        name: 'open_dev_url',
+        description: 'Opens devServerUrl from config (e.g. exp://…).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: { type: 'string', enum: ['ios', 'android'] },
+            },
+        },
+    },
+];
+function stringEnv(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return undefined;
+    }
+    const out = {};
+    for (const [key, v] of Object.entries(value)) {
+        if (typeof v === 'string') {
+            out[key] = v;
+        }
+    }
+    return Object.keys(out).length ? out : undefined;
+}
+export function handleMcpToolCall(runtime, name, args) {
+    try {
+        switch (name) {
+            case 'list_devices':
+                return { text: runtime.listDevices() };
+            case 'doctor':
+                return { text: runtime.doctor(), isError: runtime.doctorFailed() };
+            case 'screenshot':
+                return {
+                    text: runtime.screenshot(typeof args?.platform === 'string' ? args.platform : undefined),
+                };
+            case 'run_maestro_flow': {
+                const flow = args?.flow;
+                if (typeof flow !== 'string' || !flow.trim()) {
+                    throw new Error('flow is required');
+                }
+                return {
+                    text: runtime.runFlow(flow, typeof args?.platform === 'string' ? args.platform : undefined, stringEnv(args?.env)),
+                };
+            }
+            case 'run_smoke_flows':
+                return {
+                    text: runtime.runSmoke(typeof args?.platform === 'string' ? args.platform : undefined, stringEnv(args?.env)),
+                };
+            case 'adb_reverse': {
+                const ports = Array.isArray(args?.ports)
+                    ? args.ports.filter((port) => typeof port === 'number')
+                    : undefined;
+                return { text: runtime.adbReverse(ports) };
+            }
+            case 'open_url': {
+                const url = args?.url;
+                if (typeof url !== 'string' || !url.trim()) {
+                    throw new Error('url is required');
+                }
+                return {
+                    text: runtime.openUrl(url, typeof args?.platform === 'string' ? args.platform : undefined),
+                };
+            }
+            case 'open_dev_url':
+                return {
+                    text: runtime.openDevUrl(typeof args?.platform === 'string' ? args.platform : undefined),
+                };
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return { text: formatError(error), isError: true };
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":""}

package/dist/mcp-server.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { handleMcpToolCall, MCP_TOOLS } from './mcp/tools.js';
+import { createRuntime } from './runtime.js';
+import { PACKAGE_NAME, PACKAGE_VERSION } from './version.js';
+const runtime = createRuntime();
+const server = new Server({ name: PACKAGE_NAME, version: PACKAGE_VERSION }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: MCP_TOOLS,
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const result = handleMcpToolCall(runtime, name, args ?? undefined);
+    return {
+        content: [{ type: 'text', text: result.text }],
+        ...(result.isError ? { isError: true } : {}),
+    };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+function shutdown() {
+    process.exit(0);
+}
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);
+main().catch((error) => {
+    process.stderr.write(`[${PACKAGE_NAME}] fatal: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAEhC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,EAChD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE,SAAS;CACjB,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,MAAM,MAAM,GAAG,iBAAiB,CAC9B,OAAO,EACP,IAAI,EACH,IAA4C,IAAI,SAAS,CAC3D,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9C,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEhC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,YAAY,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CACvF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,20 @@
+import { type LoadConfigOptions } from './config.js';
+export declare class Runtime {
+    private readonly options;
+    private config;
+    private lastDoctor;
+    constructor(options?: LoadConfigOptions);
+    private cfg;
+    listDevices(): string;
+    screenshot(platform?: string): string;
+    runFlow(flow: string, platform?: string, env?: Record<string, string>): string;
+    runSmoke(platform?: string, env?: Record<string, string>): string;
+    adbReverse(ports?: number[]): string;
+    openUrl(url: string, platform?: string): string;
+    openDevUrl(platform?: string): string;
+    doctor(): string;
+    doctorFailed(): boolean;
+}
+export declare function createRuntime(options?: LoadConfigOptions): Runtime;
+export declare const MobileAgentRuntime: typeof Runtime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAc,MAAM,aAAa,CAAC;AAejF,qBAAa,OAAO;IAIN,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,UAAU,CAA8B;gBAEnB,OAAO,GAAE,iBAAsB;IAI5D,OAAO,CAAC,GAAG;IAIX,WAAW;IAIX,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM;IAI5B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAcxD,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE;IAI3B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAItC,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM;IAS5B,MAAM;IAKN,YAAY;CAIb;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,iBAAiB,WAExD;AAED,eAAO,MAAM,kBAAkB,gBAAU,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,71 @@
+import { assertPlatform, loadConfig } from './config.js';
+import { adbReverse } from './driver/adb.js';
+import { resolveDevServerEnv } from './driver/dev-server.js';
+import { listDevices } from './driver/devices.js';
+import { doctorHasFailures, formatDoctorReport, runDoctor, } from './driver/doctor.js';
+import { runMaestroFlow, runMaestroFlows } from './driver/maestro.js';
+import { openUrl } from './driver/open-url.js';
+import { captureScreenshot } from './driver/screenshot.js';
+import { AgentError, ErrorCode } from './errors.js';
+export class Runtime {
+    options;
+    config;
+    lastDoctor = null;
+    constructor(options = {}) {
+        this.options = options;
+        this.config = loadConfig(this.options);
+    }
+    cfg() {
+        return this.config;
+    }
+    listDevices() {
+        return listDevices();
+    }
+    screenshot(platform) {
+        return captureScreenshot(this.cfg(), assertPlatform(platform));
+    }
+    runFlow(flow, platform, env) {
+        return runMaestroFlow(this.cfg(), {
+            flow,
+            platform: assertPlatform(platform),
+            env,
+        });
+    }
+    runSmoke(platform, env) {
+        const config = this.cfg();
+        if (!config.smokeFlows.length) {
+            throw new AgentError('smokeFlows is empty in mobile-agent.config.json', ErrorCode.NOT_CONFIGURED);
+        }
+        return runMaestroFlows(config, config.smokeFlows, {
+            platform: assertPlatform(platform),
+            env,
+        });
+    }
+    adbReverse(ports) {
+        return adbReverse(ports ?? [8081]);
+    }
+    openUrl(url, platform) {
+        return openUrl(url, assertPlatform(platform));
+    }
+    openDevUrl(platform) {
+        const env = resolveDevServerEnv(this.cfg().devServerUrl);
+        const url = Object.values(env)[0];
+        if (!url) {
+            throw new AgentError('devServerUrl missing in config', ErrorCode.NOT_CONFIGURED);
+        }
+        return openUrl(url, assertPlatform(platform));
+    }
+    doctor() {
+        this.lastDoctor = runDoctor(this.cfg());
+        return formatDoctorReport(this.lastDoctor);
+    }
+    doctorFailed() {
+        const checks = this.lastDoctor ?? runDoctor(this.cfg());
+        return doctorHasFailures(checks);
+    }
+}
+export function createRuntime(options) {
+    return new Runtime(options);
+}
+export const MobileAgentRuntime = Runtime;
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,UAAU,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAEL,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,GACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,OAAO,OAAO;IAIW;IAHrB,MAAM,CAAgC;IACtC,UAAU,GAAyB,IAAI,CAAC;IAEhD,YAA6B,UAA6B,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;QAC1D,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAEO,GAAG;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,WAAW;QACT,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,UAAU,CAAC,QAAiB;QAC1B,OAAO,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,CAAC,IAAY,EAAE,QAAiB,EAAE,GAA4B;QACnE,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE;YAChC,IAAI;YACJ,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC;YAClC,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,QAAiB,EAAE,GAA4B;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,UAAU,CAClB,iDAAiD,EACjD,SAAS,CAAC,cAAc,CACzB,CAAC;QACJ,CAAC;QACD,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE;YAChD,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC;YAClC,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,KAAgB;QACzB,OAAO,UAAU,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,QAAiB;QACpC,OAAO,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,UAAU,CAAC,QAAiB;QAC1B,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,UAAU,CAAC,gCAAgC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACxC,OAAO,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED,YAAY;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACxD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+export declare const PACKAGE_VERSION: string;
+export declare const PACKAGE_NAME: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,QAAc,CAAC;AAC3C,eAAO,MAAM,YAAY,QAAW,CAAC"}

package/dist/version.js

@@ -0,0 +1,4 @@
+import pkg from '../package.json' with { type: 'json' };
+export const PACKAGE_VERSION = pkg.version;
+export const PACKAGE_NAME = pkg.name;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAExD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC;AAC3C,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC"}

package/mobile-agent.config.example.json

@@ -0,0 +1,20 @@
+{
+  "projectRoot": ".",
+  "flowsDir": "e2e/maestro/flows",
+  "screenshotDir": "artifacts/mobile-screenshots",
+  "smokeFlows": ["smoke-login", "smoke-logout"],
+  "devServerUrl": {
+    "scheme": "exp",
+    "port": 8081,
+    "hostEnv": "EXPO_DEV_HOST",
+    "outputEnvKey": "EXPO_URL"
+  },
+  "maestro": {
+    "bin": "maestro",
+    "defaultEnv": {},
+    "appId": {
+      "ios": "com.example.app.ios",
+      "android": "com.example.app"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "mobile-agent-mcp",
+  "version": "0.1.1",
+  "description": "Drive iOS sims, Android emulators, and USB devices from Cursor, Claude, or shell. Maestro flows, screenshots, adb, simctl. MCP + CLI.",
+  "license": "MIT",
+  "author": {
+    "name": "Anthony Batista",
+    "url": "https://entkreis.de"
+  },
+  "homepage": "https://github.com/anthonysbr/mobile-agent-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthonysbr/mobile-agent-mcp.git"
+  },
+  "bugs": "https://github.com/anthonysbr/mobile-agent-mcp/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "mobile-agent": "dist/cli.js",
+    "mobile-agent-mcp": "dist/mcp-server.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "CHANGELOG.md",
+    "mobile-agent.config.example.json"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start:mcp": "node dist/mcp-server.js",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src tests",
+    "format": "biome check --write src tests",
+    "check": "pnpm lint && pnpm typecheck && pnpm test && pnpm build",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "commander": "^13.1.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.16",
+    "@types/node": "^22.13.10",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "keywords": [
+    "mcp",
+    "maestro",
+    "mobile",
+    "e2e",
+    "adb",
+    "simctl",
+    "agent",
+    "ios",
+    "android"
+  ]
+}