Tauri Development MCP Server

Build, test, and debug mobile and desktop apps with the Tauri framework faster with automated UI interaction, screenshots, DOM state, and console logs from your app under development.

GitHub
MCP Server Tauri

MCP Server Tauri

Give your AI assistant superpowers for Tauri development

npm version crates.io 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

CategoryCapabilities
🎯 UI AutomationScreenshots, clicks, typing, scrolling, element finding, visual element picker
🔍 IPC MonitoringCapture and inspect Tauri IPC calls in real-time
📱 Mobile DevList iOS simulators & Android emulators
📋 LogsStream console, Android logcat, iOS, and 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: Xcode (macOS) or Android SDK

1. Configure Your AI Assistant

Use install-mcp to add the server to your AI assistant:

npx -y install-mcp @hypothesi/tauri-mcp-server --client claude-code

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

Claude Code 
npx -y install-mcp @hypothesi/tauri-mcp-server --client claude-code
Cursor 
npx -y install-mcp @hypothesi/tauri-mcp-server --client cursor
VS Code / Copilot 
npx -y install-mcp @hypothesi/tauri-mcp-server --client vscode
Windsurf 
npx -y install-mcp @hypothesi/tauri-mcp-server --client windsurf
Cline 
npx -y install-mcp @hypothesi/tauri-mcp-server --client cline

Restart your AI assistant after adding the configuration.

CLI Usage

If you want to call the tools directly from a terminal instead of from an MCP client:

npm install -g @hypothesi/tauri-mcp-cli
tauri-mcp driver-session start --port 9223
tauri-mcp webview-screenshot --file screenshot.png

The CLI uses MCPorter keep-alive support so driver_session state survives across separate commands.

2. Set Up the MCP Bridge Plugin

Ask your AI assistant to help configure your Tauri app:

"Help me set up the Tauri MCP Bridge plugin"

Your AI will:

  1. Examine your project to see what's already configured
  2. Show you what changes are needed (Cargo.toml, plugin registration, etc.)
  3. Ask for your permission before making any modifications

That's it! The AI handles all the setup details while keeping you in control. 🎉

Manual Setup

If you prefer to set up manually, see the Getting Started guide or the plugin documentation.

💬 Slash Commands (Prompts)

CommandDescription
/setupSet up or update the MCP bridge plugin in your Tauri project
/fix-webview-errorsFind and fix JavaScript errors in your webview
/selectVisually select an element in your app — returns metadata and screenshot

Just type the command in your AI assistant to start a guided workflow.

🧰 Available Tools (20 total)

Setup & Configuration
ToolDescription
get_setup_instructionsGet setup/update instructions for the MCP Bridge plugin
UI Automation — Screenshots, clicks, typing, and more
ToolDescription
driver_sessionStart/stop/status automation session
webview_find_elementFind elements by selector
read_logsRead console, Android, iOS, or system logs
webview_interactClick, scroll, swipe, focus, long-press
webview_screenshotCapture webview screenshots
webview_keyboardType text or send key events
webview_wait_forWait for elements, text, or events
webview_get_stylesGet computed CSS styles
webview_execute_jsExecute JavaScript in webview
webview_dom_snapshotGet structured accessibility tree snapshot
webview_select_elementVisual element picker — user clicks an element, returns metadata + screenshot
webview_get_pointed_elementGet metadata for element user Alt+Shift+Clicked
manage_windowList windows, get info, or resize

Multi-Window Support: All webview tools accept an optional windowId parameter to target specific windows. Use manage_window with action: "list" to discover available windows.

IPC & Plugin — Deep Tauri integration
ToolDescription
ipc_execute_commandExecute Tauri IPC commands
ipc_get_backend_stateGet app metadata and state
ipc_monitorStart/stop IPC monitoring
ipc_get_capturedGet captured IPC traffic
ipc_emit_eventEmit custom events
Mobile Development — Device listing
ToolDescription
list_devicesList Android devices and iOS simulators

🏗️ 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, macOS, Android, and iOS
  • ✅ 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
Project Structure 
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
Releasing 
# 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

🤝 Contributing

Contributions are welcome! Please:

  1. Follow existing code patterns
  2. Add tests for new features
  3. Update documentation
  4. Ensure npm test and npm run standards pass

📄 License

MIT © hypothesi

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.

관련 서버