autojs6-mcp-bridge 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Bridge, DRAIN_TIMEOUT_MS, INITIALIZE_ATTEMPTS, INITIALIZE_RETRY_DELAY_MS, isRetryableConnectionError, type BridgeConfig } from './bridge.js';
+export { AdbForward, AdbForwardError, spawnRunner, type CommandResult, type CommandRunner } from './forward.js';
+export { BRIDGE_ERROR_CODE, describeError } from './errors.js';
+export { ADB_ENV, DEFAULT_URL, OptionError, TOKEN_ENV, USAGE, endpointPort, isLoopback, parseOptions, type BridgeOptions, type ParsedCommand } from './options.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Bridge, DRAIN_TIMEOUT_MS, INITIALIZE_ATTEMPTS, INITIALIZE_RETRY_DELAY_MS, isRetryableConnectionError } from './bridge.js';
+export { AdbForward, AdbForwardError, spawnRunner } from './forward.js';
+export { BRIDGE_ERROR_CODE, describeError } from './errors.js';
+export { ADB_ENV, DEFAULT_URL, OptionError, TOKEN_ENV, USAGE, endpointPort, isLoopback, parseOptions } from './options.js';

package/dist/options.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Command line and environment parsing for the bridge. The token is read from
+ * `AUTOJS6_MCP_TOKEN` first so that it never has to appear in process arguments;
+ * `--token` is accepted for one-off use and produces a warning.
+ */
+export declare const DEFAULT_URL = "http://127.0.0.1:9637/mcp";
+export declare const TOKEN_ENV = "AUTOJS6_MCP_TOKEN";
+export declare const ADB_ENV = "AUTOJS6_MCP_ADB";
+export interface BridgeOptions {
+    /** Streamable HTTP endpoint of the phone, for example `http://127.0.0.1:9637/mcp`. */
+    url: URL;
+    /** Bearer token copied from the plugin settings page. */
+    token: string;
+    /** `adb -s <serial>` target; implies `forward`. */
+    serial?: string;
+    /** Run `adb forward tcp:<port> tcp:<port>` before connecting and remove it on exit. */
+    forward: boolean;
+    /** adb executable; defaults to `adb` on the PATH. */
+    adb: string;
+    /** Protocol version to request from the phone instead of the one the client asked for. */
+    protocol?: string;
+    /** Warnings collected while parsing; printed to stderr by the CLI. */
+    warnings: string[];
+}
+export type ParsedCommand = {
+    kind: 'run';
+    options: BridgeOptions;
+} | {
+    kind: 'help';
+} | {
+    kind: 'version';
+};
+export declare class OptionError extends Error {
+}
+export declare const USAGE = "Usage: autojs6-mcp-bridge [options]\n\nBridges a stdio MCP client to the AutoJs6 MCP Server plugin over Streamable HTTP.\n\nOptions:\n  --url <url>          Endpoint of the phone (default: http://127.0.0.1:9637/mcp)\n  --serial <serial>    Run \"adb -s <serial> forward\" for the endpoint port and remove it on exit\n  --forward            Run \"adb forward\" without -s (single device or emulator)\n  --adb <path>         adb executable (default: adb on the PATH, or AUTOJS6_MCP_ADB)\n  --protocol <date>    Request this MCP protocol version from the phone instead of the client's\n  --token <token>      Bearer token; prefer the AUTOJS6_MCP_TOKEN environment variable\n  -h, --help           Show this help\n  -v, --version        Show the version\n\nEnvironment:\n  AUTOJS6_MCP_TOKEN    Bearer token from the plugin settings page (preferred over --token)\n  AUTOJS6_MCP_ADB      adb executable when it is not on the PATH\n";
+export declare function parseOptions(argv: readonly string[], env: NodeJS.ProcessEnv): ParsedCommand;
+export declare function isLoopback(hostname: string): boolean;
+/** The TCP port of the endpoint, with the scheme default when the URL has none. */
+export declare function endpointPort(url: URL): number;

package/dist/options.js

@@ -0,0 +1,118 @@
+/**
+ * Command line and environment parsing for the bridge. The token is read from
+ * `AUTOJS6_MCP_TOKEN` first so that it never has to appear in process arguments;
+ * `--token` is accepted for one-off use and produces a warning.
+ */
+export const DEFAULT_URL = 'http://127.0.0.1:9637/mcp';
+export const TOKEN_ENV = 'AUTOJS6_MCP_TOKEN';
+export const ADB_ENV = 'AUTOJS6_MCP_ADB';
+export class OptionError extends Error {
+}
+const FLAGS_WITH_VALUE = new Set(['--url', '--token', '--serial', '--adb', '--protocol']);
+const FLAGS_WITHOUT_VALUE = new Set(['--forward', '--help', '-h', '--version', '-v']);
+const PROTOCOL_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+export const USAGE = `Usage: autojs6-mcp-bridge [options]
+
+Bridges a stdio MCP client to the AutoJs6 MCP Server plugin over Streamable HTTP.
+
+Options:
+  --url <url>          Endpoint of the phone (default: ${DEFAULT_URL})
+  --serial <serial>    Run "adb -s <serial> forward" for the endpoint port and remove it on exit
+  --forward            Run "adb forward" without -s (single device or emulator)
+  --adb <path>         adb executable (default: adb on the PATH, or ${ADB_ENV})
+  --protocol <date>    Request this MCP protocol version from the phone instead of the client's
+  --token <token>      Bearer token; prefer the ${TOKEN_ENV} environment variable
+  -h, --help           Show this help
+  -v, --version        Show the version
+
+Environment:
+  ${TOKEN_ENV}    Bearer token from the plugin settings page (preferred over --token)
+  ${ADB_ENV}      adb executable when it is not on the PATH
+`;
+export function parseOptions(argv, env) {
+    const values = new Map();
+    const flags = new Set();
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        const equals = arg.indexOf('=');
+        if (arg.startsWith('--') && equals > 0 && FLAGS_WITH_VALUE.has(arg.slice(0, equals))) {
+            values.set(arg.slice(0, equals), arg.slice(equals + 1));
+            continue;
+        }
+        if (FLAGS_WITH_VALUE.has(arg)) {
+            const value = argv[index + 1];
+            if (value === undefined || value.startsWith('--')) {
+                throw new OptionError(`${arg} needs a value`);
+            }
+            values.set(arg, value);
+            index += 1;
+            continue;
+        }
+        if (FLAGS_WITHOUT_VALUE.has(arg)) {
+            flags.add(arg);
+            continue;
+        }
+        throw new OptionError(`Unknown argument: ${arg}\n\n${USAGE}`);
+    }
+    if (flags.has('--help') || flags.has('-h')) {
+        return { kind: 'help' };
+    }
+    if (flags.has('--version') || flags.has('-v')) {
+        return { kind: 'version' };
+    }
+    const warnings = [];
+    const url = parseUrl(values.get('--url') ?? DEFAULT_URL);
+    const serial = values.get('--serial')?.trim() || undefined;
+    const forward = flags.has('--forward') || serial !== undefined;
+    if (forward && !isLoopback(url.hostname)) {
+        throw new OptionError(`--serial / --forward only make sense with a loopback URL; ${url.origin} is reached over the network directly`);
+    }
+    const envToken = env[TOKEN_ENV]?.trim();
+    const argToken = values.get('--token')?.trim();
+    if (argToken) {
+        warnings.push(`--token is visible to other processes; prefer the ${TOKEN_ENV} environment variable`);
+    }
+    if (envToken && argToken && envToken !== argToken) {
+        warnings.push(`both ${TOKEN_ENV} and --token are set; using ${TOKEN_ENV}`);
+    }
+    const token = envToken || argToken;
+    if (!token) {
+        throw new OptionError(`No token: set ${TOKEN_ENV} (copy it from the plugin settings page) or pass --token`);
+    }
+    if (!/^[A-Za-z0-9_-]{32,256}$/.test(token)) {
+        throw new OptionError('The token must be 32 to 256 characters of letters, digits, "-" or "_"; copy it again from the plugin settings page');
+    }
+    const protocol = values.get('--protocol')?.trim() || undefined;
+    if (protocol !== undefined && !PROTOCOL_PATTERN.test(protocol)) {
+        throw new OptionError(`--protocol expects a version date such as 2025-06-18, not "${protocol}"`);
+    }
+    const adb = values.get('--adb')?.trim() || env[ADB_ENV]?.trim() || 'adb';
+    return { kind: 'run', options: { url, token, serial, forward, adb, protocol, warnings } };
+}
+function parseUrl(text) {
+    let url;
+    try {
+        url = new URL(text);
+    }
+    catch {
+        throw new OptionError(`--url is not a valid URL: "${text}"`);
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new OptionError(`--url must start with http:// or https://, not ${url.protocol}`);
+    }
+    if (url.username || url.password) {
+        throw new OptionError('--url must not contain credentials; the token goes into the environment');
+    }
+    return url;
+}
+export function isLoopback(hostname) {
+    const host = hostname.replace(/^\[|\]$/g, '');
+    return host === 'localhost' || host === '::1' || /^127\.\d+\.\d+\.\d+$/.test(host);
+}
+/** The TCP port of the endpoint, with the scheme default when the URL has none. */
+export function endpointPort(url) {
+    if (url.port) {
+        return Number(url.port);
+    }
+    return url.protocol === 'https:' ? 443 : 80;
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "autojs6-mcp-bridge",
+  "version": "0.1.0",
+  "description": "stdio to Streamable HTTP bridge for the AutoJs6 MCP Server plugin: lets stdio-only MCP clients such as Claude Desktop reach the phone",
+  "keywords": [
+    "autojs6",
+    "mcp",
+    "model-context-protocol",
+    "android",
+    "stdio",
+    "bridge"
+  ],
+  "homepage": "https://github.com/SuperMonster003/AutoJs6-MCP-Bridge#readme",
+  "bugs": {
+    "url": "https://github.com/SuperMonster003/AutoJs6-MCP-Bridge/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SuperMonster003/AutoJs6-MCP-Bridge.git"
+  },
+  "license": "MPL-2.0",
+  "author": "SuperMonster003",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "autojs6-mcp-bridge": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README-zh-Hans.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test",
+    "prepack": "npm run build",
+    "pack:check": "npm pack --dry-run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0"
+  },
+  "devDependencies": {
+    "@types/node": "^18.19.0",
+    "typescript": "^5.6.0"
+  }
+}