@hypothesi/tauri-mcp-server 0.6.4 → 0.7.0

package/dist/driver/plugin-commands.js

@@ -41,11 +41,25 @@ export async function manageIPCMonitoring(action, appIdentifier) {
 }
 export async function startIPCMonitoring(appIdentifier) {
     try {
+        // Start the Rust-side monitor state
         const result = await executeIPCCommand({ command: 'plugin:mcp-bridge|start_ipc_monitor', appIdentifier });
         const parsed = JSON.parse(result);
         if (!parsed.success) {
             throw new Error(parsed.error || 'Unknown error');
         }
+        // Start the JS-side IPC interception
+        const client = await ensureSessionAndConnect(appIdentifier);
+        const jsResponse = await client.sendCommand({
+            command: 'execute_js',
+            args: {
+                script: 'window.__MCP_START_IPC_MONITOR__ && window.__MCP_START_IPC_MONITOR__(); true;',
+                windowLabel: 'main',
+            },
+        }, 5000);
+        if (!jsResponse.success) {
+            // Log but don't fail - Rust-side monitoring is still active
+            console.error('Failed to start JS-side IPC interception:', jsResponse.error);
+        }
         return JSON.stringify(parsed.result);
     }
     catch (error) {
@@ -55,6 +69,20 @@ export async function startIPCMonitoring(appIdentifier) {
 }
 export async function stopIPCMonitoring(appIdentifier) {
     try {
+        // Stop the JS-side IPC interception first
+        const client = await ensureSessionAndConnect(appIdentifier);
+        const jsResponse = await client.sendCommand({
+            command: 'execute_js',
+            args: {
+                script: 'window.__MCP_STOP_IPC_MONITOR__ && window.__MCP_STOP_IPC_MONITOR__(); true;',
+                windowLabel: 'main',
+            },
+        }, 5000);
+        if (!jsResponse.success) {
+            // Log but don't fail - continue to stop Rust-side monitoring
+            console.error('Failed to stop JS-side IPC interception:', jsResponse.error);
+        }
+        // Stop the Rust-side monitor state
         const result = await executeIPCCommand({ command: 'plugin:mcp-bridge|stop_ipc_monitor', appIdentifier });
         const parsed = JSON.parse(result);
         if (!parsed.success) {

package/dist/driver/webview-executor.js

@@ -285,11 +285,11 @@ async function prepareHtml2canvasScript(format, quality) {
 /**
  * Capture a screenshot of the entire webview.
  *
- * @param options - Screenshot options (format, quality, windowId, appIdentifier)
+ * @param options - Screenshot options (format, quality, windowId, appIdentifier, etc.)
  * @returns Screenshot result with image content
  */
 export async function captureScreenshot(options = {}) {
-    const { format = 'png', quality = 90, windowId, appIdentifier } = options;
+    const { format = 'png', quality = 90, windowId, appIdentifier, maxWidth } = options;
     // Primary implementation: Use native platform-specific APIs
     // - macOS: WKWebView takeSnapshot
     // - Windows: WebView2 CapturePreview
@@ -307,6 +307,7 @@ export async function captureScreenshot(options = {}) {
                 format,
                 quality,
                 windowLabel: windowId,
+                maxWidth,
             },
         }, 15000);
         if (!response.success || !response.data) {

package/dist/driver/webview-interactions.js

@@ -36,6 +36,8 @@ export const ScreenshotSchema = WindowTargetSchema.extend({
     format: z.enum(['png', 'jpeg']).optional().default('png').describe('Image format'),
     quality: z.number().min(0).max(100).optional().describe('JPEG quality (0-100, only for jpeg format)'),
     filePath: z.string().optional().describe('File path to save the screenshot to instead of returning as base64'),
+    maxWidth: z.number().int().positive().optional().describe('Maximum width in pixels. Images wider than this will be scaled down proportionally. ' +
+        'Can also be set via TAURI_MCP_SCREENSHOT_MAX_WIDTH environment variable.'),
 });
 export const KeyboardSchema = WindowTargetSchema.extend({
     action: z.enum(['type', 'press', 'down', 'up'])
@@ -121,9 +123,9 @@ async function performSwipe(options) {
     }
 }
 export async function screenshot(options = {}) {
-    const { quality, format = 'png', windowId, filePath, appIdentifier } = options;
+    const { quality, format = 'png', windowId, filePath, appIdentifier, maxWidth } = options;
     // Use the native screenshot function from webview-executor
-    const result = await captureScreenshot({ format, quality, windowId, appIdentifier });
+    const result = await captureScreenshot({ format, quality, windowId, appIdentifier, maxWidth });
     // If filePath is provided, write to file instead of returning base64
     if (filePath) {
         // Find the image content in the result

package/dist/monitor/logs.js

@@ -1,6 +1,49 @@
 import { z } from 'zod';
 import { execa } from 'execa';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
 import { getConsoleLogs } from '../driver/webview-interactions.js';
+/**
+ * Find the adb executable path. Checks environment variables first, then common
+ * installation locations on macOS, Linux, and Windows. This is necessary because
+ * MCP servers often run without ANDROID_HOME set (e.g., global npm installs).
+ */
+function findAdbPath() {
+    // Check environment variables first
+    // eslint-disable-next-line no-process-env
+    const androidHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
+    if (androidHome) {
+        const envPath = join(androidHome, 'platform-tools', 'adb');
+        if (existsSync(envPath)) {
+            return envPath;
+        }
+    }
+    // Common installation locations to check
+    const home = homedir();
+    const commonPaths = [
+        // macOS - Android Studio default
+        join(home, 'Library', 'Android', 'sdk', 'platform-tools', 'adb'),
+        // Linux - Android Studio default
+        join(home, 'Android', 'Sdk', 'platform-tools', 'adb'),
+        // Linux - alternative location
+        join(home, 'android-sdk', 'platform-tools', 'adb'),
+        // Windows - Android Studio default
+        join(home, 'AppData', 'Local', 'Android', 'Sdk', 'platform-tools', 'adb.exe'),
+        // Homebrew on macOS
+        '/opt/homebrew/bin/adb',
+        '/usr/local/bin/adb',
+        // Linux system-wide
+        '/usr/bin/adb',
+    ];
+    for (const adbPath of commonPaths) {
+        if (existsSync(adbPath)) {
+            return adbPath;
+        }
+    }
+    // Fall back to PATH (will fail if not in PATH, but gives a clear error)
+    return 'adb';
+}
 export const ReadLogsSchema = z.object({
     source: z.enum(['console', 'android', 'ios', 'system'])
         .describe('Log source: "console" for webview JS logs, "android" for logcat, "ios" for simulator, "system" for desktop'),
@@ -19,10 +62,7 @@ export async function readLogs(options) {
             return await getConsoleLogs({ filter, since, windowId, appIdentifier });
         }
         if (source === 'android') {
-            // Find adb - check ANDROID_HOME first, then fall back to PATH
-            // eslint-disable-next-line no-process-env
-            const androidHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
-            const adbPath = androidHome ? `${androidHome}/platform-tools/adb` : 'adb';
+            const adbPath = findAdbPath();
             const args = ['logcat', '-d'];
             if (since) {
                 // adb logcat -T expects "MM-DD HH:MM:SS.mmm"

package/dist/prompts-registry.js

@@ -2,6 +2,7 @@
  * Single source of truth for all MCP prompt definitions
  * Prompts are user-controlled templates that appear as slash commands in MCP clients
  */
+import { PLUGIN_VERSION_CARGO } from './version.js';
 const FIX_WEBVIEW_ERRORS_PROMPT = `I need help finding and fixing JavaScript errors in my Tauri app's webview.
 
 Please follow these steps:
@@ -49,7 +50,7 @@ Examine these files and report what needs to be added or updated:
 Check \`src-tauri/Cargo.toml\` for \`tauri-plugin-mcp-bridge\`. If missing or outdated, note that it needs:
 \`\`\`toml
 [dependencies]
-tauri-plugin-mcp-bridge = "0.4"
+tauri-plugin-mcp-bridge = "${PLUGIN_VERSION_CARGO}"
 \`\`\`
 
 ### 2. Plugin Registration

package/dist/tools-registry.js

@@ -8,6 +8,7 @@ import { manageDriverSession, ManageDriverSessionSchema, } from './driver/sessio
 import { readLogs, ReadLogsSchema } from './monitor/logs.js';
 import { executeIPCCommand, manageIPCMonitoring, getIPCEvents, emitTestEvent, getBackendState, manageWindow, ExecuteIPCCommandSchema, ManageIPCMonitoringSchema, GetIPCEventsSchema, EmitTestEventSchema, GetBackendStateSchema, ManageWindowSchema, } from './driver/plugin-commands.js';
 import { interact, screenshot, keyboard, waitFor, getStyles, executeJavaScript, findElement, InteractSchema, ScreenshotSchema, KeyboardSchema, WaitForSchema, GetStylesSchema, ExecuteJavaScriptSchema, FindElementSchema, } from './driver/webview-interactions.js';
+import { PLUGIN_VERSION_CARGO } from './version.js';
 /**
  * Standard multi-app description for webview tools.
  */
@@ -50,7 +51,7 @@ Examine these files and report what needs to be added or updated:
 Check \`src-tauri/Cargo.toml\` for \`tauri-plugin-mcp-bridge\`. If missing or outdated, note that it needs:
 \`\`\`toml
 [dependencies]
-tauri-plugin-mcp-bridge = "0.4"
+tauri-plugin-mcp-bridge = "${PLUGIN_VERSION_CARGO}"
 \`\`\`
 
 ### 2. Plugin Registration
@@ -248,6 +249,7 @@ export const TOOLS = [
                 windowId: parsed.windowId,
                 filePath: parsed.filePath,
                 appIdentifier: parsed.appIdentifier,
+                maxWidth: parsed.maxWidth,
             });
             // If saved to file, return text confirmation
             if ('filePath' in result) {

package/dist/version.js

@@ -0,0 +1,17 @@
+/**
+ * Version information for the MCP Bridge plugin.
+ *
+ * Reads the version from this package's package.json at runtime.
+ * Both packages share the same version (monorepo single-version policy).
+ */
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url), pkg = require('../package.json'), [major, minor] = pkg.version.split('.');
+/**
+ * Full version string (e.g., "0.6.5")
+ */
+export const PLUGIN_VERSION_FULL = pkg.version;
+/**
+ * Cargo-compatible version string for Cargo.toml dependencies (e.g., "0.6")
+ * This is the major.minor version used in Cargo.toml dependency specifications.
+ */
+export const PLUGIN_VERSION_CARGO = `${major}.${minor}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypothesi/tauri-mcp-server",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "mcpName": "io.github.hypothesi/mcp-server-tauri",
   "description": "A Model Context Protocol server for use with Tauri v2 applications",
   "type": "module",