MCP Server Tauri

Give your AI assistant superpowers for Tauri development

npm version License: MIT Tauri v2

Documentation · Getting Started · Available Tools

A Model Context Protocol (MCP) server that enables AI assistants like Claude, Cursor, and Windsurf to build, test, and debug Tauri v2 applications. Screenshots, DOM state, and console logs from your running app give the AI rich context to understand what's happening—and tools to interact with it.

✨ Features

Category	Capabilities
🎯 UI Automation	Screenshots, clicks, typing, scrolling—all via WebSocket
🔍 IPC Monitoring	Capture and inspect Tauri IPC calls in real-time
📱 Mobile Dev	Manage Android emulators & iOS simulators
🛠️ CLI Integration	Run any Tauri command ( `init` , `dev` , `build` , etc.)
⚙️ Configuration	Read/write Tauri config files with validation
📋 Logs	Stream Android logcat, iOS device logs, system logs

Disclaimer: This MCP was developed using agentic coding tools. It may contain bugs.

🚀 Quick Start

Prerequisites

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

1. Add the MCP Bridge Plugin to Your Tauri App

Add to

[dependencies] tauri-plugin-mcp-bridge = "0.1"

Register in

fn main() { tauri::Builder::default() .plugin(tauri_plugin_mcp_bridge::init()) .run(tauri::generate_context!()) .expect("error while running tauri application"); }

2. Configure Your AI Assistant

Use the Claude Code CLI:

claude mcp add tauri npx @hypothesi/tauri-mcp-server

Or manually add to your config (Cmd/Ctrl+Shift+P → "MCP: Edit Config"):

{ "mcpServers": { "tauri": { "command": "npx", "args": ["-y", "@hypothesi/tauri-mcp-server"] } } }

Click to install:

Or manually: Go to Cursor Settings → MCP → New MCP Server:

{ "mcpServers": { "tauri": { "command": "npx", "args": ["-y", "@hypothesi/tauri-mcp-server"] } } }

Click to install:

Or via CLI:

code --add-mcp '{"name":"tauri","command":"npx","args":["-y","@hypothesi/tauri-mcp-server"]}'

Or manually add to

{ "mcp.servers": { "tauri": { "command": "npx", "args": ["-y", "@hypothesi/tauri-mcp-server"] } } }

Go to Settings → AI → MCP Servers:

{ "mcpServers": { "tauri": { "command": "npx", "args": ["-y", "@hypothesi/tauri-mcp-server"] } } }

Follow the Cline MCP configuration guide and use:

{ "mcpServers": { "tauri": { "command": "npx", "args": ["-y", "@hypothesi/tauri-mcp-server"] } } }

That's it! Restart your AI assistant and you're ready to build Tauri apps. 🎉

Note: See the plugin documentation for advanced configuration options.

🧰 Available Tools

Tool	Description
`tauri_webview_screenshot`	Capture webview screenshots
`tauri_driver_session`	Start/stop automation session
`tauri_webview_find_element`	Find elements by selector
`tauri_webview_interact`	Click, scroll, swipe, long-press
`tauri_webview_keyboard`	Type text or send key events
`tauri_webview_wait_for`	Wait for elements, text, or events
`tauri_webview_get_styles`	Get computed CSS styles
`tauri_webview_execute_js`	Execute JavaScript in webview
`tauri_webview_focus_element`	Focus on elements
`tauri_driver_get_console_logs`	Get browser console logs
`tauri_read_platform_logs`	Read Android/iOS/system logs

Tool	Description
`tauri_plugin_execute_ipc`	Execute Tauri IPC commands
`tauri_plugin_get_window_info`	Get window information
`tauri_plugin_get_backend_state`	Get app metadata and state
`tauri_plugin_ipc_monitor`	Start/stop IPC monitoring
`tauri_plugin_ipc_get_events`	Get captured IPC events
`tauri_plugin_emit_event`	Emit custom events

Tool	Description
`tauri_list_devices`	List Android devices and iOS simulators
`tauri_launch_emulator`	Launch Android AVD or iOS Simulator

Tool	Description
`tauri_run_command`	Run any Tauri CLI command
`tauri_read_config`	Read Tauri config files (including platform-specific)
`tauri_write_config`	Write config files with validation
`tauri_get_docs`	Fetch Tauri documentation

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐ │ AI Assistant │ │ (Claude, Cursor, Windsurf) │ └─────────────────────────┬───────────────────────────────────────┘ │ MCP Protocol (stdio) ▼ ┌─────────────────────────────────────────────────────────────────┐ │ MCP Server (Node.js) │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │ │ │ Manager │ │ Driver │ │ Monitor │ │ │ │ CLI/Config │ │ UI Automation│ │ Logs/IPC Events │ │ │ └──────────────┘ └──────┬───────┘ └──────────────────────┘ │ └─────────────────────────────┼───────────────────────────────────┘ │ WebSocket (port 9223) ▼ ┌─────────────────────────────────────────────────────────────────┐ │ Tauri Application │ │ ┌──────────────────────────────────────────────────────────┐ │ │ │ MCP Bridge Plugin (Rust) │ │ │ │ IPC Commands • Events • Backend State │ │ │ └──────────────────────────────────────────────────────────┘ │ │ ┌──────────────────────────────────────────────────────────┐ │ │ │ Webview (DOM/UI) │ │ │ └──────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘

Why this approach?

✅ Rich AI context — Screenshots, DOM, and logs help the AI understand your app's state
✅ Cross-platform — Works on Linux, Windows, and macOS
✅ No external drivers — No Selenium, Playwright, or browser automation needed
✅ Native integration — Direct access to Tauri's IPC and backend

🧑‍💻 Development

# Clone and install git clone https://github.com/hypothesi/mcp-server-tauri.git cd mcp-server-tauri npm install # Build all packages npm run build # Run tests npm test # Development mode npm run dev -w @hypothesi/tauri-mcp-server

mcp-server-tauri/ ├── packages/ │ ├── mcp-server/ # MCP server (TypeScript) │ ├── tauri-plugin-mcp-bridge/ # Tauri plugin (Rust + JS bindings) │ └── test-app/ # Test Tauri application ├── docs/ # VitePress documentation └── specs/ # Architecture specs

# Release plugin (Cargo + npm) npm run release:plugin patch # Release server (npm only) npm run release:server patch

See specs/releasing.md for details.

📚 Documentation

Full Documentation — Guides, API reference, and examples
MCP Server Package — Server implementation details
MCP Bridge Plugin — Tauri plugin documentation

🤝 Contributing

Contributions are welcome! Please:

Follow existing code patterns
Add tests for new features
Update documentation
Ensure npm test and npm run standards pass

MCP Server Tauri

MCP Server Tauri

✨ Features

🚀 Quick Start

Prerequisites

1. Add the MCP Bridge Plugin to Your Tauri App

2. Configure Your AI Assistant

🧰 Available Tools

🏗️ Architecture

🧑‍💻 Development

📚 Documentation

🤝 Contributing

📄 License

Related Resources

New MCP Servers

MCP directory API