Skip to content
Back to search

tauri-mcp-skills

MarketplaceWorks with Claude CodeGitHub

A Model Context Protocol (MCP) server and plugin for Tauri v2 development

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hypothesi--mcp-server-tauri/badge.svg)](/listings/hypothesi--mcp-server-tauri)

HTML

<a href="/listings/hypothesi--mcp-server-tauri"><img src="/api/listings/hypothesi--mcp-server-tauri/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- **Node.js** 20+ and npm - **Rust** and Cargo (for [Tauri](https://tauri.app) development) - **Tauri CLI**: `npm install -g @tauri-apps/cli@next` - For mobile: Xcode (macOS) or Android SDK

1. Configure Your AI Assistant

Use [aix](https://aix.a1st.dev/cli/add/#aix-add-mcp) to add the server to your AI assistant:

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

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

> [!TIP] > `aix` automatically detects your installed AI assistants and configures them.

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

<details> <summary><strong>Manual Setup</strong></summary>

If you prefer to set up manually, see the [Getting Started guide](https://hypothesi.github.io/mcp-server-tauri/guides/getting-started.html) or the [plugin documentation](./packages/tauri-plugin-mcp-bridge/README.md).

</details>

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 31 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "tauri-mcp-skills",
  3. "owner": {
  4. "name": "hypothesi",
  5. "url": "https://github.com/hypothesi"
  6. },
  7. "metadata": {
  8. "description": "Agent skills for automating and testing Tauri v2 applications using the MCP server.",
  9. "version": "0.11.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "tauri-mcp-cli",
  14. "description": "Agent Skills for automating, inspecting, and testing Tauri v2 applications directly from the terminal. Includes skills for driver-session management, webview inspection, and UI interactions.",
  15. "author": {
  16. "name": "hypothesi",
  17. "url": "https://github.com/hypothesi"
  18. },
  19. "homepage": "https://github.com/hypothesi/mcp-server-tauri",
  20. "tags": [
  21. "tauri",
  22. "mcp",
  23. "automation",
  24. "testing",
  25. "cli",
  26. "webview"
  27. ],
  28. "source": "./packages/cli"
  29. }
  30. ]
  31. }
README.md · README · 286 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="docs/public/logo.svg" alt="MCP Server Tauri" width="120" height="120" />
  3. # MCP Server Tauri
  4. **Give your AI assistant superpowers for Tauri development**
  5. [![npm version](https://img.shields.io/npm/v/@hypothesi/tauri-mcp-server?style=flat-square&color=0ea5e9)](https://www.npmjs.com/package/@hypothesi/tauri-mcp-server)
  6. [![crates.io](https://img.shields.io/crates/v/tauri-plugin-mcp-bridge?style=flat-square&color=e6522c)](https://crates.io/crates/tauri-plugin-mcp-bridge)
  7. [![License: MIT](https://img.shields.io/badge/License-MIT-8b5cf6.svg?style=flat-square)](LICENSE)
  8. [![Tauri v2](https://img.shields.io/badge/Tauri-v2-FFC131?style=flat-square&logo=tauri&logoColor=white)](https://v2.tauri.app)
  9. [Documentation](https://hypothesi.github.io/mcp-server-tauri) · [Getting Started](#quick-start) · [Available Tools](#available-tools)
  10. </div>
  11. ---
  12. A **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.
  13. ## ✨ Features
  14. | Category | Capabilities |
  15. |----------|-------------|
  16. | 🎯 **UI Automation** | Screenshots, clicks, typing, scrolling, element finding, visual element picker |
  17. | 🔍 **IPC Monitoring** | Capture and inspect Tauri IPC calls in real-time |
  18. | 📱 **Mobile Dev** | List iOS simulators & Android emulators |
  19. | 📋 **Logs** | Stream console, Android logcat, iOS, and system logs |
  20. ---
  21. > _Disclaimer: This MCP was developed using agentic coding tools. It may contain bugs._
  22. ## 🚀 Quick Start
  23. ### Prerequisites
  24. - **Node.js** 20+ and npm
  25. - **Rust** and Cargo (for [Tauri](https://tauri.app) development)
  26. - **Tauri CLI**: `npm install -g @tauri-apps/cli@next`
  27. - For mobile: Xcode (macOS) or Android SDK
  28. ### 1. Configure Your AI Assistant
  29. Use [aix](https://aix.a1st.dev/cli/add/#aix-add-mcp) to add the server to your AI assistant:
  30. ```bash
  31. npx -y @a1st/aix add mcp tauri --command 'npx @hypothesi/tauri-mcp-server' --user
  32. ```
  33. Supported clients: `claude-code`, `cursor`, `windsurf`, `vscode`, `cline`, `roo-cline`, `claude`, `zed`, `goose`, `warp`, `codex`
  34. > [!TIP]
  35. > `aix` automatically detects your installed AI assistants and configures them.
  36. **Restart your AI assistant** after adding the configuration.
  37. ### CLI Usage
  38. If you want to call the tools directly from a terminal instead of from an MCP client:
  39. ```bash
  40. npm install -g @hypothesi/tauri-mcp-cli
  41. tauri-mcp driver-session start --port 9223
  42. tauri-mcp webview-screenshot --file screenshot.png
  43. ```
  44. The CLI uses MCPorter keep-alive support so `driver_session` state survives across separate commands.
  45. ### 2. Set Up the MCP Bridge Plugin
  46. Ask your AI assistant to help configure your Tauri app:
  47. > "Help me set up the Tauri MCP Bridge plugin"
  48. Your AI will:
  49. 1. **Examine your project** to see what's already configured
  50. 2. **Show you what changes are needed** (Cargo.toml, plugin registration, etc.)
  51. 3. **Ask for your permission** before making any modifications
  52. That's it! The AI handles all the setup details while keeping you in control. 🎉
  53. <details>
  54. <summary><strong>Manual Setup</strong></summary>
  55. If you prefer to set up manually, see the [Getting Started guide](https://hypothesi.github.io/mcp-server-tauri/guides/getting-started.html) or the [plugin documentation](./packages/tauri-plugin-mcp-bridge/README.md).
  56. </details>
  57. ---
  58. ## 💬 Slash Commands (Prompts)
  59. | Command | Description |
  60. |---------|-------------|
  61. | `/setup` | Set up or update the MCP bridge plugin in your Tauri project |
  62. | `/fix-webview-errors` | Find and fix JavaScript errors in your webview |
  63. | `/select` | Visually select an element in your app — returns metadata and screenshot |
  64. Just type the command in your AI assistant to start a guided workflow.
  65. ---
  66. ## 🧰 Available Tools (21 total)
  67. <details>
  68. <summary><strong>Setup & Configuration</strong></summary>
  69. | Tool | Description |
  70. |------|-------------|
  71. | `get_setup_instructions` | Get setup/update instructions for the MCP Bridge plugin |
  72. </details>
  73. <details>
  74. <summary><strong>UI Automation</strong> — Screenshots, clicks, typing, and more</summary>
  75. | Tool | Description |
  76. |------|-------------|
  77. | `driver_session` | Start/stop/status automation session |
  78. | `webview_find_element` | Find elements by selector |
  79. | `read_logs` | Read console, Android, iOS, or system logs |
  80. | `webview_interact` | Click, scroll, swipe, focus, long-press |
  81. | `webview_screenshot` | Capture webview screenshots |
  82. | `webview_keyboard` | Type text or send key events |
  83. | `webview_wait_for` | Wait for elements, text, or events |
  84. | `webview_get_styles` | Get computed CSS styles |
  85. | `webview_execute_js` | Execute JavaScript in webview |
  86. | `webview_dom_snapshot` | Get structured accessibility tree snapshot |
  87. | `webview_select_element` | Visual element picker — user clicks an element, returns metadata + screenshot |
  88. | `webview_get_pointed_element` | Get metadata for element user Alt+Shift+Clicked |
  89. | `manage_window` | List windows, get info, or resize |
  90. > **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.
  91. </details>
  92. <details>
  93. <summary><strong>IPC & Plugin</strong> — Deep Tauri integration</summary>
  94. | Tool | Description |
  95. |------|-------------|
  96. | `ipc_execute_command` | Execute Tauri IPC commands |
  97. | `ipc_get_backend_state` | Get app metadata and state |
  98. | `ipc_monitor` | Start/stop IPC monitoring |
  99. | `ipc_get_captured` | Get captured IPC traffic |
  100. | `ipc_emit_event` | Emit custom events |
  101. </details>
  102. <details>
  103. <summary><strong>Mobile Development</strong> — Device listing</summary>
  104. | Tool | Description |
  105. |------|-------------|
  106. | `list_devices` | List Android devices and iOS simulators |
  107. </details>
  108. ---
  109. ## 🏗️ Architecture
  110. ```
  111. ┌─────────────────────────────────────────────────────────────────┐
  112. │ AI Assistant │
  113. │ (Claude, Cursor, Windsurf) │
  114. └─────────────────────────┬───────────────────────────────────────┘
  115. │ MCP Protocol (stdio)
  116. ▼
  117. ┌─────────────────────────────────────────────────────────────────┐
  118. │ MCP Server (Node.js) │
  119. │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │
  120. │ │ Manager │ │ Driver │ │ Monitor │ │
  121. │ │ CLI/Config │ │ UI Automation│ │ Logs/IPC Events │ │
  122. │ └──────────────┘ └──────┬───────┘ └──────────────────────┘ │
  123. └─────────────────────────────┼───────────────────────────────────┘
  124. │ WebSocket (port 9223)
  125. ▼
  126. ┌─────────────────────────────────────────────────────────────────┐
  127. │ Tauri Application │
  128. │ ┌──────────────────────────────────────────────────────────┐ │
  129. │ │ MCP Bridge Plugin (Rust) │ │
  130. │ │ IPC Commands • Events • Backend State │ │
  131. │ └──────────────────────────────────────────────────────────┘ │
  132. │ ┌──────────────────────────────────────────────────────────┐ │
  133. │ │ Webview (DOM/UI) │ │
  134. │ └──────────────────────────────────────────────────────────┘ │
  135. └─────────────────────────────────────────────────────────────────┘
  136. ```
  137. **Why this approach?**
  138. - ✅ **Rich AI context** — Screenshots, DOM, and logs help the AI understand your app's state
  139. - ✅ **Cross-platform** — Works on Linux, Windows, macOS, Android, and iOS
  140. - ✅ **No external drivers** — No Selenium, Playwright, or browser automation needed
  141. - ✅ **Native integration** — Direct access to Tauri's IPC and backend
  142. ---
  143. ## 🧑‍💻 Development
  144. ```bash
  145. # Clone and install
  146. git clone https://github.com/hypothesi/mcp-server-tauri.git
  147. cd mcp-server-tauri
  148. npm install
  149. # Build all packages
  150. npm run build
  151. # Run tests
  152. npm test
  153. # Development mode
  154. npm run dev -w @hypothesi/tauri-mcp-server
  155. ```
  156. <details>
  157. <summary><strong>Project Structure</strong></summary>
  158. ```
  159. mcp-server-tauri/
  160. ├── packages/
  161. │ ├── mcp-server/ # MCP server (TypeScript)
  162. │ ├── tauri-plugin-mcp-bridge/ # Tauri plugin (Rust + JS bindings)
  163. │ └── test-app/ # Test Tauri application
  164. ├── docs/ # VitePress documentation
  165. └── specs/ # Architecture specs
  166. ```
  167. </details>
  168. <details>
  169. <summary><strong>Releasing</strong></summary>
  170. ```bash
  171. # Release plugin (Cargo + npm)
  172. npm run release:plugin patch
  173. # Release server (npm only)
  174. npm run release:server patch
  175. ```
  176. See [specs/releasing.md](./specs/releasing.md) for details.
  177. </details>
  178. ---
  179. ## 📚 Documentation
  180. - **[Full Documentation](https://hypothesi.github.io/mcp-server-tauri)** — Guides, API reference, and examples
  181. - **[MCP Server Package](./packages/mcp-server/)** — Server implementation details
  182. - **[MCP Bridge Plugin](./packages/tauri-plugin-mcp-bridge/)** — Tauri plugin documentation
  183. ---
  184. ## 🤝 Contributing
  185. Contributions are welcome! Please:
  186. 1. Follow existing code patterns
  187. 2. Add tests for new features
  188. 3. Update documentation
  189. 4. Ensure `npm test` and `npm run standards` pass
  190. ---
  191. ## Other Notes
  192. This project is tested with BrowserStack.
  193. ## 📄 License
  194. MIT © [hypothesi](https://github.com/hypothesi)
  195. ---
  196. ## Trademark Notice
  197. TAURI® is a registered trademark of The Tauri Programme within the Commons Conservancy. [https://tauri.app/](https://tauri.app/)
  198. This project is not affiliated with, endorsed by, or sponsored by The Tauri Programme within the Commons Conservancy.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.