A Model Context Protocol (MCP) server for Tauri v2 applications. It enables AI assistants to build, test, and debug Tauri-based apps by providing standardized model context services and tooling integration.

🛠️ Key Features

MCP server that works with Tauri v2 environments
Enables AI assistants to interact with Tauri applications for context-aware actions
Supports automation, CLI workflows, and Gemini CLI extension compatibility
Clear readme and documentation references for setup and usage

🚀 Use Cases

Integrating model context services into Tauri-based IDE workflows
Testing and debugging MCP-enabled Tauri apps with AI assistants
Automating common development tasks via MCP in a Tauri environment

⚡ Developer Benefits

Standardized MCP interface for Tauri v2 apps
Quick-start documentation and npm packaging for easy adoption
Compatibility with popular AI assistants and Gemini CLI extensions

⚠️ Limitations

Specific capabilities may depend on the host AI assistant support for MCP
Documentation depth may vary; refer to full docs for detailed integration steps

@hypothesi/tauri-mcp-server

npm version License: MIT

A Model Context Protocol (MCP) server that enables AI assistants like Claude, Cursor, and Windsurf to build, test, and debug Tauri® v2 applications.

📖 Full Documentation

Features

Category	Capabilities
🎯 UI Automation	Screenshots, clicks, typing, scrolling, element finding, visual element picker
🔍 IPC Monitoring	Capture and inspect Tauri IPC calls in real-time
📱 Mobile Dev	List Android emulators & iOS simulators
📋 Logs	Stream console, Android logcat, iOS, and system logs

Quick Start

1. Add the MCP Bridge Plugin to Your Tauri App

bash

cargo add tauri-plugin-mcp-bridge

rust

// src-tauri/src/main.rs
fn main() {
    let mut builder = tauri::Builder::default();

    #[cfg(debug_assertions)]
    {
        builder = builder.plugin(tauri_plugin_mcp_bridge::init());
    }

    builder
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

Note: The npm package @hypothesi/tauri-plugin-mcp-bridge is optional—only needed if you want to call the plugin from your app's frontend code. The MCP server communicates with the Rust plugin directly via WebSocket.

2. Configure Your AI Assistant

Use aix to add the server to your AI assistant:

bash

npx -y @a1st/aix add mcp tauri --command 'npx @hypothesi/tauri-mcp-server' --user

Supported clients: claude-code, cursor, windsurf, vscode, cline, roo-cline, claude, zed, goose, warp, codex

Terminal CLI

If you want to call the same tools directly from a shell, install the companion CLI package:

bash

npm install -g @hypothesi/tauri-mcp-cli
tauri-mcp driver-session start --port 9223
tauri-mcp driver-session status --json

The CLI keeps the underlying MCP server warm in the background so stateful commands such as driver_session work across separate invocations.

Multi-App Support

The MCP server supports connecting to multiple Tauri apps simultaneously. Each app runs on a unique port, and the most recently connected app becomes the "default" app.

Key Features:

Connect to multiple apps on different ports
Default app used when no appIdentifier specified
Target specific apps using port number or bundle ID
Stop individual sessions or all sessions at once

Example Usage:

javascript

// Connect to first app
await driver_session({ action: "start", port: 9223 })

// Connect to second app
await driver_session({ action: "start", port: 9224 })

// Check status - shows both apps with default indicator
await driver_session({ action: "status" })

// Use default app (most recent - port 9224)
await webview_screenshot()

// Target specific app by port
await webview_screenshot({ appIdentifier: 9223 })

// Stop specific app
await driver_session({ action: "stop", appIdentifier: 9223 })

// Stop all apps
await driver_session({ action: "stop" })

Available Tools (20 total)

Setup & Configuration

Tool	Description
`get_setup_instructions`	Get setup/update instructions for the MCP Bridge plugin

UI Automation

Tool	Description
`driver_session`	Start/stop/status automation session
`webview_find_element`	Find elements by CSS selector, XPath, text, or ref ID
`read_logs`	Read console, Android, iOS, or system logs
`webview_interact`	Click, scroll, swipe, focus, long-press
`webview_screenshot`	Capture webview screenshots (JPEG default)
`webview_keyboard`	Type text or send key events
`webview_wait_for`	Wait for elements, text, or events
`webview_get_styles`	Get computed CSS styles
`webview_execute_js`	Execute JavaScript in webview
`webview_dom_snapshot`	Get structured DOM snapshot (accessibility or structure)
`webview_select_element`	Visual element picker — user clicks an element, returns metadata + screenshot
`webview_get_pointed_element`	Get metadata for element user Alt+Shift+Clicked
`manage_window`	List windows, get info, or resize

IPC & Plugin

Tool	Description
`ipc_execute_command`	Execute Tauri IPC commands
`ipc_get_backend_state`	Get app metadata and state
`ipc_monitor`	Start/stop IPC monitoring
`ipc_get_captured`	Get captured IPC traffic
`ipc_emit_event`	Emit custom events

Mobile Development

Tool	Description
`list_devices`	List Android devices and iOS simulators

License

Trademark Notice

TAURI® is a registered trademark of The Tauri Programme within the Commons Conservancy. https://tauri.app/

This project is not affiliated with, endorsed by, or sponsored by The Tauri Programme within the Commons Conservancy.

io.github.hypothesi/mcp-server-tauri

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

@hypothesi/tauri-mcp-server

Features

Quick Start

1. Add the MCP Bridge Plugin to Your Tauri App

2. Configure Your AI Assistant

Terminal CLI

Multi-App Support

Available Tools (20 total)

Setup & Configuration

UI Automation

IPC & Plugin

Mobile Development

Links

License

Trademark Notice

Install

Related servers