# mcp-server-tauri

An MCP server for Tauri v2 apps that lets AI agents inspect the UI, read logs, monitor IPC, and run debugging actions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 326
- Author: hypothesi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hypothesi/mcp-server-tauri/tree/HEAD/packages/mcp-server
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-server-tauri

## What it does

mcp-server-tauri gives an AI assistant tools for Tauri v2 development. It can take webview screenshots, find elements, click, type, scroll, wait for UI changes, inspect computed styles, and run JavaScript. The same server reads console, Android, iOS, and system logs, while its IPC tools capture traffic, execute commands, and inspect backend state.

A Tauri app needs the Rust bridge plugin before the server can connect. Add it with `cargo add tauri-plugin-mcp-bridge`, then initialize `tauri_plugin_mcp_bridge::init()` in `src-tauri/src/main.rs` under `#[cfg(debug_assertions)]`. The server talks to the Rust plugin over WebSocket. Without that bridge, the app connection will not work.

Multiple Tauri apps can stay connected on separate ports. The most recently connected app is the default; `appIdentifier` can target another app by port or bundle ID. A companion CLI keeps the MCP server warm so stateful `driver_session` calls work across shell invocations.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-server-tauri -- npx -y @hypothesi/tauri-mcp-server
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server -- npx -y @hypothesi/tauri-mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@hypothesi/tauri-mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@hypothesi/tauri-mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-server npx -y @hypothesi/tauri-mcp-server
```

## When to use it
- inspect and operate a Tauri webview with an agent
- capture screenshots while testing the app UI
- trace and inspect Tauri IPC traffic
- read desktop and mobile application logs
- connect several Tauri apps on separate ports

## Example prompts
- Inspect the current webview, find the login button, and click it.
- Connect to the app on port `9223`, then show its recent IPC traffic.
- Take a screenshot after entering the test email in the webview.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md