{
  "markdown": "<div align=\"center\">\n\n<img src=\"docs/public/logo.svg\" alt=\"MCP Server Tauri\" width=\"120\" height=\"120\" />\n\n# MCP Server Tauri\n\n**Give your AI assistant superpowers for Tauri development**\n\n[![npm version](https://img.shields.io/npm/v/@hushlor/tauri-mcp-server?style=flat-square&color=0ea5e9)](https://www.npmjs.com/package/@hushlor/tauri-mcp-server)\n[![crates.io](https://img.shields.io/crates/v/tauri-plugin-hushlor-mcp-bridge?style=flat-square&color=e6522c)](https://crates.io/crates/tauri-plugin-hushlor-mcp-bridge)\n[![License: MIT](https://img.shields.io/badge/License-MIT-8b5cf6.svg?style=flat-square)](LICENSE)\n[![Tauri v2](https://img.shields.io/badge/Tauri-v2-FFC131?style=flat-square&logo=tauri&logoColor=white)](https://v2.tauri.app)\n\n[Documentation](https://hushlor.github.io/mcp-server-tauri/) · [Getting Started](#quick-start) · [Available Tools](#available-tools)\n\n</div>\n\n---\n\nA **Model Context Protocol (MCP) server** that enables AI assistants like Claude, Cursor, and Windsurf to build, test, and debug [Tauri®](https://tauri.app) 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.\n\n## ✨ Features\n\n| Category | Capabilities |\n|----------|-------------|\n| 🎯 **UI Automation** | Screenshots, clicks, typing, scrolling, element finding, visual element picker |\n| 🔍 **IPC Monitoring** | Capture and inspect Tauri IPC calls in real-time |\n| 📱 **Mobile Dev** | List iOS simulators & Android emulators |\n| 📋 **Logs** | Stream console, Android logcat, iOS, and system logs |\n\n---\n\n> _Disclaimer: This MCP was developed using agentic coding tools. It may contain bugs._\n\n> **Independent downstream fork:** This distribution is maintained by Hushlor and is released independently of the original [hypothesi/mcp-server-tauri](https://github.com/hypothesi/mcp-server-tauri) project. It preserves the upstream MIT license and attribution while allowing downstream features and releases without upstream approval.\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- **Node.js** 20+ and npm\n- **Rust** and Cargo (for [Tauri](https://tauri.app) development)\n- **Tauri CLI**: `npm install -g @tauri-apps/cli@next`\n- For mobile: Xcode (macOS) or Android SDK\n\n### 1. Configure Your AI Assistant\n\nUse [aix](https://aix.a1st.dev/cli/add/#aix-add-mcp) to add the server to your AI assistant:\n\n```bash\nnpx -y @a1st/aix add mcp tauri --command 'npx @hushlor/tauri-mcp-server' --user\n```\n\nSupported clients: `claude-code`, `cursor`, `windsurf`, `vscode`, `cline`, `roo-cline`, `claude`, `zed`, `goose`, `warp`, `codex`\n\n> [!TIP]\n> `aix` automatically detects your installed AI assistants and configures them.\n\n**Restart your AI assistant** after adding the configuration.\n\n### CLI Usage\n\nIf you want to call the tools directly from a terminal instead of from an MCP client:\n\n```bash\nnpm install -g @hushlor/tauri-mcp-cli\ntauri-mcp driver-session start --port 9223\ntauri-mcp webview-screenshot --file screenshot.png\n```\n\nThe CLI uses MCPorter keep-alive support so `driver_session` state survives across separate commands.\n\n### 2. Set Up the MCP Bridge Plugin\n\nAsk your AI assistant to help configure your Tauri app:\n\n> \"Help me set up the Tauri MCP Bridge plugin\"\n\nYour AI will:\n\n1. **Examine your project** to see what's already configured\n2. **Show you what changes are needed** (Cargo.toml, plugin registration, etc.)\n3. **Ask for your permission** before making any modifications\n\nThat's it! The AI handles all the setup details while keeping you in control. 🎉\n\n<details>\n<summary><strong>Manual Setup</strong></summary>\n\nIf you prefer to set up manually, see the [Getting Started guide](https://hushlor.github.io/mcp-server-tauri/guides/getting-started.html) or the [plugin documentation](./packages/tauri-plugin-mcp-bridge/README.md).\n\n</details>\n\n---\n\n## 💬 Slash Commands (Prompts)\n\n| Command | Description |\n|---------|-------------|\n| `/setup` | Set up or update the MCP bridge plugin in your Tauri project |\n| `/fix-webview-errors` | Find and fix JavaScript errors in your webview |\n| `/select` | Visually select an element in your app — returns metadata and screenshot |\n\nJust type the command in your AI assistant to start a guided workflow.\n\n---\n\n## 🧰 Available Tools (22 total)\n\n<details>\n<summary><strong>Setup & Configuration</strong></summary>\n\n| Tool | Description |\n|------|-------------|\n| `get_setup_instructions` | Get setup/update instructions for the MCP Bridge plugin |\n\n</details>\n\n<details>\n<summary><strong>UI Automation</strong> — Screenshots, clicks, typing, and more</summary>\n\n| Tool | Description |\n|------|-------------|\n| `driver_session` | Start/stop/status automation session |\n| `webview_find_element` | Find elements by selector |\n| `read_logs` | Read console, Android, iOS, or system logs |\n| `webview_interact` | Click, scroll, swipe, focus, long-press |\n| `webview_screenshot` | Capture webview screenshots |\n| `native_dialog_snapshot` | Inspect app-owned native Windows dialog chains and navigation controls |\n| `native_dialog_interact` | Invoke, set single/multiple paths, or select native Windows dialog controls |\n| `webview_keyboard` | Type text or send key events |\n| `webview_wait_for` | Wait for elements, text, or events |\n| `webview_get_styles` | Get computed CSS styles |\n| `webview_execute_js` | Execute JavaScript in webview |\n| `webview_dom_snapshot` | Get structured accessibility tree snapshot |\n| `webview_select_element` | Visual element picker — user clicks an element, returns metadata + screenshot |\n| `webview_get_pointed_element` | Get metadata for element user Alt+Shift+Clicked |\n| `manage_window` | List windows, get info, or resize |\n\n> **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.\n\n> **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.\n\n</details>\n\n<details>\n<summary><strong>IPC & Plugin</strong> — Deep Tauri integration</summary>\n\n| Tool | Description |\n|------|-------------|\n| `ipc_execute_command` | Execute Tauri IPC commands |\n| `ipc_get_backend_state` | Get app metadata and state |\n| `ipc_monitor` | Start/stop IPC monitoring |\n| `ipc_get_captured` | Get captured IPC traffic |\n| `ipc_emit_event` | Emit custom events |\n\n</details>\n\n<details>\n<summary><strong>Mobile Development</strong> — Device listing</summary>\n\n| Tool | Description |\n|------|-------------|\n| `list_devices` | List Android devices and iOS simulators |\n\n</details>\n\n---\n\n## 🏗️ Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                        AI Assistant                             │\n│                  (Claude, Cursor, Windsurf)                     │\n└─────────────────────────┬───────────────────────────────────────┘\n                          │ MCP Protocol (stdio)\n                          ▼\n┌─────────────────────────────────────────────────────────────────┐\n│                     MCP Server (Node.js)                        │\n│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────┐   │\n│  │   Manager    │  │    Driver    │  │      Monitor         │   │\n│  │  CLI/Config  │  │ UI Automation│  │   Logs/IPC Events    │   │\n│  └──────────────┘  └──────┬───────┘  └──────────────────────┘   │\n└─────────────────────────────┼───────────────────────────────────┘\n                              │ WebSocket (port 9223)\n                              ▼\n┌─────────────────────────────────────────────────────────────────┐\n│                      Tauri Application                          │\n│  ┌──────────────────────────────────────────────────────────┐   │\n│  │              MCP Bridge Plugin (Rust)                    │   │\n│  │         IPC Commands • Events • Backend State            │   │\n│  └──────────────────────────────────────────────────────────┘   │\n│  ┌──────────────────────────────────────────────────────────┐   │\n│  │                    Webview (DOM/UI)                      │   │\n│  └──────────────────────────────────────────────────────────┘   │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n**Why this approach?**\n\n- ✅ **Rich AI context** — Screenshots, DOM, and logs help the AI understand your app's state\n- ✅ **Cross-platform** — Works on Linux, Windows, macOS, Android, and iOS\n- ✅ **No external drivers** — No Selenium, Playwright, or browser automation needed\n- ✅ **Native integration** — Direct access to Tauri's IPC and backend\n\n---\n\n## 🧑‍💻 Development\n\n```bash\n# Clone and install\ngit clone https://github.com/Hushlor/mcp-server-tauri.git\ncd mcp-server-tauri\nnpm install\n\n# Build all packages\nnpm run build\n\n# Run tests\nnpm test\n\n# Development mode\nnpm run dev -w @hushlor/tauri-mcp-server\n```\n\n<details>\n<summary><strong>Project Structure</strong></summary>\n\n```\nmcp-server-tauri/\n├── packages/\n│   ├── mcp-server/              # MCP server (TypeScript)\n│   ├── cli/                      # Published CLI wrapper\n│   ├── tauri-plugin-mcp-bridge/ # Tauri plugin (Rust + JS bindings)\n│   └── test-app/                # Test Tauri application\n├── docs/                        # VitePress documentation\n└── specs/                       # Architecture specs\n```\n\n</details>\n\n<details>\n<summary><strong>Releasing</strong></summary>\n\n```bash\n# Validate the current coordinated release locally (no publish/tag)\nnode scripts/release-package.js 0.14.0 --dry-run\n```\n\nPublishing packages or creating and pushing tags requires explicit authorization. See [specs/releasing.md](./specs/releasing.md) for the bootstrap and coordinated release procedure.\n\n</details>\n\n---\n\n## 📚 Documentation\n\n- **[Full Documentation](https://hushlor.github.io/mcp-server-tauri/)** — Guides, API reference, and examples\n- **[MCP Server Package](./packages/mcp-server/)** — Server implementation details\n- **[MCP Bridge Plugin](./packages/tauri-plugin-mcp-bridge/)** — Tauri plugin documentation\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please:\n\n1. Follow existing code patterns\n2. Add tests for new features\n3. Update documentation\n4. Ensure `npm test` and `npm run standards` pass\n\n---\n\n## Other Notes\n\nThis project is tested with BrowserStack.\n\n## 📄 License\n\nMIT © Hushlor. Original upstream copyright and attribution are preserved in [LICENSE](./LICENSE); see [hypothesi/mcp-server-tauri](https://github.com/hypothesi/mcp-server-tauri) for provenance.\n\n---\n\n## Trademark Notice\n\nTAURI® is a registered trademark of The Tauri Programme within the Commons Conservancy. [https://tauri.app/](https://tauri.app/)\n\nThis project is not affiliated with, endorsed by, or sponsored by The Tauri Programme within the Commons Conservancy.\n",
  "bytes": 11009,
  "sha": "f3a382d375029afde2423b4009f7edf53863bbd0b18714c825fe24cad2bd9397",
  "repo_slug": "hushlor/mcp-server-tauri",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hushlor_mcp_server_tauri_c5ae4d1e/readme"
}