tauri-mcp
A Tauri plugin that lets AI agents (Claude Code, Cursor, etc.) interact with your Tauri app through screenshots, DOM inspection, and input simulation using the Model Context Protocol (MCP).
Features
- Screenshots — capture the app window on macOS, Linux, and Windows
- DOM access — read the full HTML of any webview window
- Element interaction — click, type, drag, hover via simulated input
- JavaScript execution — run arbitrary JS in the webview context
- Element position — find elements by id, class, tag, or text content
Installation
# Cargo.toml
[dependencies]
tauri-plugin-mcp = { git = "https://github.com/DonsWayo/tauri-mcp", optional = true }
Register the plugin in your Tauri app:
// src-tauri/src/lib.rs
#[cfg(feature = "mcp-e2e")]
app.plugin(tauri_plugin_mcp::init())?;
The plugin opens a Unix domain socket at /tmp/<app-name>-mcp.sock that MCP clients connect to.
macOS Screenshots
The plugin uses screencapture -l <CGWindowID> instead of xcap. This means:
- No Screen Recording permission required for the Tauri app itself
- Only Terminal (or your terminal emulator) needs Screen Recording access
- Works with unsigned debug builds without code signing entitlements
- Avoids a crash in
xcap::Window::all()triggered by certain system windows on recent macOS versions
Linux Screenshots
Uses xcap for X11 window capture with multi-pass window matching by app name and title.
Usage with Claude Code
Add to .mcp.json:
{
"mcpServers": {
"nucel-e2e": {
"type": "stdio",
"command": "node",
"args": ["path/to/mcp-server/build/index.js", "/tmp/your-app-mcp.sock"]
}
}
}
This project started as a fork of P3GLEG/tauri-plugin-mcp and has since diverged significantly.
License
MIT
