appium-mcp 1.92.8 → 1.92.9

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [1.92.9](https://github.com/appium/appium-mcp/compare/v1.92.8...v1.92.9) (2026-08-28)
+
+### Bug Fixes
+
+* followup for [#493](https://github.com/appium/appium-mcp/issues/493) ([#496](https://github.com/appium/appium-mcp/issues/496)) ([75aa0e1](https://github.com/appium/appium-mcp/commit/75aa0e1f987ef99503e3587978bd1be8aca0e7f6))
+
 ## [1.92.8](https://github.com/appium/appium-mcp/compare/v1.92.7...v1.92.8) (2026-08-28)
 
 ### Bug Fixes

package/README.md

@@ -538,7 +538,13 @@ const server = await createAppiumMcpServer({
 await server.start({ transportType: 'stdio' });
 ```
 
-`start({ transportType: 'stdio' })` keeps Appium and WebDriver logs off stdout so JSON-RPC stays intact. httpStream is unchanged.
+### Stdio logging
+
+`start({ transportType: 'stdio' })` automatically configures Appium and WebDriver logging before the stdio transport starts, keeping stdout reserved for JSON-RPC. You normally do not need to configure logging separately.
+
+In stdio mode, `WDIO_LOG_LEVEL` values that would write verbose output to stdout (`trace`, `debug`, and `info`) are clamped to `warn`. Quieter `error` and `silent` values are preserved. This behavior only applies to stdio; `httpStream` logging is unchanged.
+
+For advanced integrations that need to configure logging explicitly, `configureStdioTransportLogging()` is exported from `appium-mcp/core`. Call it before starting stdio work; calling `server.start({ transportType: 'stdio' })` already invokes it automatically.
 
 Plugin lifecycle:
 

package/dist/utils/wdio-logging.d.ts

@@ -1,6 +1,3 @@
-import wdioLogger from '@wdio/logger';
-type WdioLogLevel = NonNullable<Parameters<typeof wdioLogger.setLogLevelsConfig>[1]>;
 /** Quiet every WDIO logger that was created before stdio config ran. */
-export declare function quietExistingWdioLoggers(level?: WdioLogLevel): void;
-export {};
+export declare function quietExistingWdioLoggers(): void;
 //# sourceMappingURL=wdio-logging.d.ts.map

package/dist/utils/wdio-logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wdio-logging.d.ts","sourceRoot":"","sources":["../../src/utils/wdio-logging.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,cAAc,CAAC;AAItC,KAAK,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAErF,wEAAwE;AACxE,wBAAgB,wBAAwB,CACtC,KAAK,GAAE,YAAoG,GAC1G,IAAI,CAEN"}
+{"version":3,"file":"wdio-logging.d.ts","sourceRoot":"","sources":["../../src/utils/wdio-logging.ts"],"names":[],"mappings":"AAcA,wEAAwE;AACxE,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C"}

package/dist/utils/wdio-logging.js

@@ -1,7 +1,14 @@
 import wdioLogger from '@wdio/logger';
 import { QUIET_WEBDRIVER_LOG_LEVEL } from './webdriver-client-options.js';
+const STDIO_SAFE_WDIO_LEVELS = new Set(['warn', 'error', 'silent']);
+function getStdioWdioLogLevel() {
+    const configuredLevel = process.env.WDIO_LOG_LEVEL?.trim().toLowerCase();
+    return configuredLevel && STDIO_SAFE_WDIO_LEVELS.has(configuredLevel) ? configuredLevel : QUIET_WEBDRIVER_LOG_LEVEL;
+}
 /** Quiet every WDIO logger that was created before stdio config ran. */
-export function quietExistingWdioLoggers(level = process.env.WDIO_LOG_LEVEL ?? QUIET_WEBDRIVER_LOG_LEVEL) {
+export function quietExistingWdioLoggers() {
+    const level = getStdioWdioLogLevel();
+    process.env.WDIO_LOG_LEVEL = level;
     wdioLogger.setLogLevelsConfig({}, level);
 }
 //# sourceMappingURL=wdio-logging.js.map

package/dist/utils/wdio-logging.js.map

@@ -1 +1 @@
-{"version":3,"file":"wdio-logging.js","sourceRoot":"","sources":["../../src/utils/wdio-logging.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAC,yBAAyB,EAAC,MAAM,+BAA+B,CAAC;AAIxE,wEAAwE;AACxE,MAAM,UAAU,wBAAwB,CACtC,QAAuB,OAAO,CAAC,GAAG,CAAC,cAA2C,IAAI,yBAAyB;IAE3G,UAAU,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"wdio-logging.js","sourceRoot":"","sources":["../../src/utils/wdio-logging.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAC,yBAAyB,EAAC,MAAM,+BAA+B,CAAC;AAKxE,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEvF,SAAS,oBAAoB;IAC3B,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,WAAW,EAAmC,CAAC;IAC1G,OAAO,eAAe,IAAI,sBAAsB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,yBAAyB,CAAC;AACtH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,wBAAwB;IACtC,MAAM,KAAK,GAAG,oBAAoB,EAAE,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC;IACnC,UAAU,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC"}

package/dist/utils/webdriver-client-options.d.ts

@@ -1,6 +1,9 @@
 export declare const QUIET_WEBDRIVER_LOG_LEVEL: "warn";
-/** `logLevel: warn` only after stdio logging is configured. */
-export declare function withQuietWebDriverLogging<T extends Record<string, unknown>>(options: T): T | (T & {
+type QuietWebDriverLogging = {
     logLevel: typeof QUIET_WEBDRIVER_LOG_LEVEL;
-});
+    logLevels: Record<string, typeof QUIET_WEBDRIVER_LOG_LEVEL>;
+};
+/** `logLevel: warn` only after stdio logging is configured. */
+export declare function withQuietWebDriverLogging<T extends Record<string, unknown>>(options: T): T | (T & QuietWebDriverLogging);
+export {};
 //# sourceMappingURL=webdriver-client-options.d.ts.map

package/dist/utils/webdriver-client-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webdriver-client-options.d.ts","sourceRoot":"","sources":["../../src/utils/webdriver-client-options.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,EAAG,MAAe,CAAC;AAEzD,+DAA+D;AAC/D,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzE,OAAO,EAAE,CAAC,GACT,CAAC,GAAG,CAAC,CAAC,GAAG;IAAC,QAAQ,EAAE,OAAO,yBAAyB,CAAA;CAAC,CAAC,CAQxD"}
+{"version":3,"file":"webdriver-client-options.d.ts","sourceRoot":"","sources":["../../src/utils/webdriver-client-options.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,EAAG,MAAe,CAAC;AAEzD,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,EAAE,OAAO,yBAAyB,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,yBAAyB,CAAC,CAAC;CAC7D,CAAC;AAEF,+DAA+D;AAC/D,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzE,OAAO,EAAE,CAAC,GACT,CAAC,GAAG,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAgBjC"}

package/dist/utils/webdriver-client-options.js

@@ -5,9 +5,14 @@ export function withQuietWebDriverLogging(options) {
     if (!isStdioTransportLoggingConfigured()) {
         return options;
     }
+    const existingLogLevels = typeof options.logLevels === 'object' && options.logLevels !== null ? options.logLevels : {};
     return {
         ...options,
         logLevel: QUIET_WEBDRIVER_LOG_LEVEL,
+        logLevels: {
+            ...existingLogLevels,
+            webdriver: QUIET_WEBDRIVER_LOG_LEVEL,
+        },
     };
 }
 //# sourceMappingURL=webdriver-client-options.js.map

package/dist/utils/webdriver-client-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"webdriver-client-options.js","sourceRoot":"","sources":["../../src/utils/webdriver-client-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iCAAiC,EAAC,MAAM,2BAA2B,CAAC;AAE5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAe,CAAC;AAEzD,+DAA+D;AAC/D,MAAM,UAAU,yBAAyB,CACvC,OAAU;IAEV,IAAI,CAAC,iCAAiC,EAAE,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO;QACL,GAAG,OAAO;QACV,QAAQ,EAAE,yBAAyB;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"webdriver-client-options.js","sourceRoot":"","sources":["../../src/utils/webdriver-client-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iCAAiC,EAAC,MAAM,2BAA2B,CAAC;AAE5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAe,CAAC;AAOzD,+DAA+D;AAC/D,MAAM,UAAU,yBAAyB,CACvC,OAAU;IAEV,IAAI,CAAC,iCAAiC,EAAE,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,iBAAiB,GACrB,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/F,OAAO;QACL,GAAG,OAAO;QACV,QAAQ,EAAE,yBAAyB;QACnC,SAAS,EAAE;YACT,GAAG,iBAAiB;YACpB,SAAS,EAAE,yBAAyB;SACrC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-mcp",
-  "version": "1.92.8",
+  "version": "1.92.9",
   "description": "Intelligent MCP server providing AI assistants with powerful tools and resources for Appium mobile automation",
   "bugs": {
     "url": "https://github.com/appium/appium-mcp/issues"

package/server.json

@@ -3,12 +3,12 @@
   "name": "io.github.appium/appium-mcp",
   "title": "MCP Appium - Mobile Development and Automation Server",
   "description": "MCP server for Appium mobile automation on iOS and Android devices with test creation tools.",
-  "version": "1.92.8",
+  "version": "1.92.9",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "appium-mcp",
-      "version": "1.92.8",
+      "version": "1.92.9",
       "transport": {
         "type": "stdio"
       }

package/src/utils/wdio-logging.ts

@@ -3,10 +3,18 @@ import wdioLogger from '@wdio/logger';
 import {QUIET_WEBDRIVER_LOG_LEVEL} from './webdriver-client-options.js';
 
 type WdioLogLevel = NonNullable<Parameters<typeof wdioLogger.setLogLevelsConfig>[1]>;
+type StdioWdioLogLevel = Extract<WdioLogLevel, string>;
+
+const STDIO_SAFE_WDIO_LEVELS = new Set<StdioWdioLogLevel>(['warn', 'error', 'silent']);
+
+function getStdioWdioLogLevel(): StdioWdioLogLevel {
+  const configuredLevel = process.env.WDIO_LOG_LEVEL?.trim().toLowerCase() as StdioWdioLogLevel | undefined;
+  return configuredLevel && STDIO_SAFE_WDIO_LEVELS.has(configuredLevel) ? configuredLevel : QUIET_WEBDRIVER_LOG_LEVEL;
+}
 
 /** Quiet every WDIO logger that was created before stdio config ran. */
-export function quietExistingWdioLoggers(
-  level: WdioLogLevel = (process.env.WDIO_LOG_LEVEL as WdioLogLevel | undefined) ?? QUIET_WEBDRIVER_LOG_LEVEL,
-): void {
+export function quietExistingWdioLoggers(): void {
+  const level = getStdioWdioLogLevel();
+  process.env.WDIO_LOG_LEVEL = level;
   wdioLogger.setLogLevelsConfig({}, level);
 }

package/src/utils/webdriver-client-options.ts

@@ -2,15 +2,28 @@ import {isStdioTransportLoggingConfigured} from '../stdio-logging-state.js';
 
 export const QUIET_WEBDRIVER_LOG_LEVEL = 'warn' as const;
 
+type QuietWebDriverLogging = {
+  logLevel: typeof QUIET_WEBDRIVER_LOG_LEVEL;
+  logLevels: Record<string, typeof QUIET_WEBDRIVER_LOG_LEVEL>;
+};
+
 /** `logLevel: warn` only after stdio logging is configured. */
 export function withQuietWebDriverLogging<T extends Record<string, unknown>>(
   options: T,
-): T | (T & {logLevel: typeof QUIET_WEBDRIVER_LOG_LEVEL}) {
+): T | (T & QuietWebDriverLogging) {
   if (!isStdioTransportLoggingConfigured()) {
     return options;
   }
+
+  const existingLogLevels =
+    typeof options.logLevels === 'object' && options.logLevels !== null ? options.logLevels : {};
+
   return {
     ...options,
     logLevel: QUIET_WEBDRIVER_LOG_LEVEL,
+    logLevels: {
+      ...existingLogLevels,
+      webdriver: QUIET_WEBDRIVER_LOG_LEVEL,
+    },
   };
 }