MCP Server Tauri

Give your AI assistant superpowers for Tauri development

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

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

Independent downstream fork: This distribution is maintained by Hushlor and is released independently of the original hypothesi/mcp-server-tauri project. It preserves the upstream MIT license and attribution while allowing downstream features and releases without upstream approval.

Related MCP server: Mobile Device MCP

🚀 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 aix to add the server to your AI assistant:

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

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

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 @hushlor/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. 🎉

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

💬 Slash Commands (Prompts)

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

🧰 Available Tools (22 total)

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.

Native Windows dialogs: native_dialog_* tools require an interactive desktop and expose only same-process dialogs whose owner chain leads to the targeted Tauri window. They support single/multi-file Open, Save, folder selection, nested confirmations, and advertised navigation controls, but not toast notifications or other applications.

🏗️ 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/Hushlor/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 @hushlor/tauri-mcp-server

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

# Validate the current coordinated release locally (no publish/tag)
node scripts/release-package.js 0.14.0 --dry-run

Publishing packages or creating and pushing tags requires explicit authorization. See specs/releasing.md for the bootstrap and coordinated release procedure.

📚 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:

1. Follow existing code patterns

2. Add tests for new features

3. Update documentation

4. Ensure npm test and npm run standards pass

Other Notes

This project is tested with BrowserStack.

📄 License

MIT © Hushlor. Original upstream copyright and attribution are preserved in LICENSE; see hypothesi/mcp-server-tauri for provenance.

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.