MCP Server Tauri

🚀 MCP Server Tauri

Empower your AI assistant for Tauri development with enhanced capabilities.

This Model Context Protocol (MCP) server allows AI assistants such as Claude, Cursor, and Windsurf to build, test, and debug Tauri v2 applications. By providing screenshots, DOM state, and console logs from your running app, it equips the AI with rich context to understand the application's status and offers tools for interaction.

Documentation · Getting Started · Available Tools

✨ Features

⚠️ 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. Add the MCP Bridge Plugin to Your Tauri App

Add the Rust crate:

cargo add tauri-plugin-mcp-bridge

Register in 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");
}

Enable Global Tauri in tauri.conf.json:

{
  "app": {
    "withGlobalTauri": true
  }
}

⚠️ Important Note: Without withGlobalTauri, the MCP server cannot interact with your application's webview.

💡 Usage Tip: The npm package @hypothesi/tauri-plugin-mcp-bridge is optional. It provides TypeScript bindings 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 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

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

npx -y install-mcp @hypothesi/tauri-mcp-server --client cursor

npx -y install-mcp @hypothesi/tauri-mcp-server --client vscode

npx -y install-mcp @hypothesi/tauri-mcp-server --client windsurf

npx -y install-mcp @hypothesi/tauri-mcp-server --client cline

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

💡 Usage Tip: See the plugin documentation for advanced configuration options.

💬 Slash Commands (Prompts)

The server provides slash commands for guided, multi-step workflows:

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

🧰 Available Tools (16 total)

🏗️ 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

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

📚 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

📄 License

MIT © hypothesi