mcp -tauri

This MCP server enables an AI assistant to interact with Tauri v2 applications. It exposes a set of tools and capabilities for UI automation, IPC monitoring, mobile device listing, and log streaming, all geared toward helping the AI understand and debug a running Tauri app. After starting the server, connect your AI assistant to the MCP bridge and select the tauri MCP server. The available tools include UI automation commands (like webview_screenshot, webview_find_element, and webview_execute_js), IPC and plugin interactions (ipc_execute_command, ipc_monitor, ipc_emit_event), and a mobile device listing tool (list_devices) to inspect runtime behavior, logs, and IPC traffic in real time. Use the slash commands to set up the MCP bridge, fix webview errors, or visually select UI elements to gather context for the AI assistant.

Prerequisites:

• Node.js 20+ and npm
• Rust and Cargo (for Tauri development)
• Tauri CLI: npm install -g @tauri-apps/cli@next
• Optional: Xcode (macOS) or Android SDK for mobile testing

Steps:

1. Install the MCP server package:

   • npm install -g @hypothesi/tauri-mcp-server
   • or use npx to install and run as needed when configuring clients: npx -y install-mcp @hypothesi/tauri-mcp-server --client your-client

2. Configure the MCP server in your environment:

   • Ensure Node.js runtime is available
   • Set environment variables as needed (PORT, HOST, etc.)

3. Start the MCP server:

   • node path/to/server.js
   • If provided by your setup, use the npm script or npx invocation from the package documentation

4. Connect your AI assistant to the MCP bridge using the recommended install-mcp workflow and select the tauri client/toolset. Then follow the Quick Start to enable the appropriate tools for your project.

Tips and common issues:

• Ensure Node.js is version 20+ and that Rust/Cargo are installed if you plan to build or run Tauri plugins.
• The MCP bridge plugin setup steps assume you’re integrating with a Tauri project; follow the Getting Started guide for plugin registration and Cargo.toml changes.
• If you encounter IPC monitoring issues, verify that the Tauri app is running with IPC enabled and that the MCP bridge is correctly registered in the plugin configuration.
• For mobile development, ensure you have Xcode (macOS) or Android SDK installed and configured to list simulators/emulators.
• Environment variables like HOST, PORT, and WS_PATH can be adjusted to fit your local or CI environment; ensure firewall rules allow the WebSocket/IPC port.
• Restart the AI assistant after adding or updating MCP server configurations to ensure changes take effect.