MCP Server Tauri

🚀 MCP Server Tauri

為你的AI助手賦予Tauri開發的超能力

本項目提供了一個模型上下文協議（MCP）服務器，可讓Claude、Cursor和Windsurf等AI助手構建、測試和調試 Tauri v2應用程序。運行中的應用程序的截圖、DOM狀態和控制檯日誌能為AI提供豐富的上下文信息，使其瞭解應用程序的運行情況，並提供與之交互的工具。

文檔 · 快速開始 · 可用工具

✨ 主要特性

免責聲明：此MCP是使用代理編碼工具開發的，可能包含錯誤。

🚀 快速開始

前提條件

• Node.js 20+ 和 npm
• Rust 和 Cargo（用於 Tauri 開發）
• Tauri CLI：npm install -g @tauri-apps/cli@next
• 移動開發：Xcode（macOS）或Android SDK

1. 將MCP Bridge插件添加到你的Tauri應用中

添加Rust crate：

cargo add tauri-plugin-mcp-bridge

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

在 tauri.conf.json 中啟用全局Tauri：

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

⚠️ 重要提示：

如果沒有 withGlobalTauri，MCP服務器將無法與你的應用程序的WebView進行交互。

💡 使用建議：

npm包 @hypothesi/tauri-plugin-mcp-bridge 是可選的。如果你想從應用程序的前端代碼調用該插件，它提供了TypeScript綁定。MCP服務器通過WebSocket直接與Rust插件通信。

2. 配置你的AI助手

使用 install-mcp 將服務器添加到你的AI助手中：

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

支持的客戶端：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

完成以上步驟後，重啟你的AI助手，就可以開始構建Tauri應用程序了！🎉

注意：有關高級配置選項，請參閱 插件文檔。

💬 斜槓命令（提示）

服務器提供斜槓命令以實現引導式的多步驟工作流程：

只需在AI助手中輸入命令即可啟動引導式工作流程。

🧰 可用工具（共16個）

🏗️ 架構

┌─────────────────────────────────────────────────────────────────┐
│                        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)                      │   │
│  └──────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

為什麼採用這種方法？

• ✅ 豐富的AI上下文 — 截圖、DOM和日誌有助於AI瞭解你的應用程序狀態
• ✅ 跨平臺 — 適用於Linux、Windows、macOS、Android和iOS
• ✅ 無需外部驅動 — 無需Selenium、Playwright或瀏覽器自動化工具
• ✅ 原生集成 — 直接訪問Tauri的IPC和後端

🧑‍💻 開發

# 克隆並安裝
git clone https://github.com/hypothesi/mcp-server-tauri.git
cd mcp-server-tauri
npm install

# 構建所有包
npm run build

# 運行測試
npm test

# 開發模式
npm run dev -w @hypothesi/tauri-mcp-server

mcp-server-tauri/
├── packages/
│   ├── mcp-server/              # MCP服務器 (TypeScript)
│   ├── tauri-plugin-mcp-bridge/ # Tauri插件 (Rust + JS綁定)
│   └── test-app/                # 測試Tauri應用程序
├── docs/                        # VitePress文檔
└── specs/                       # 架構規範

# 發佈插件 (Cargo + npm)
npm run release:plugin patch

# 發佈服務器 (僅npm)
npm run release:server patch

📚 詳細文檔

• 完整文檔 — 指南、API參考和示例
• MCP服務器包 — 服務器實現細節
• MCP Bridge插件 — Tauri插件文檔

🤝 貢獻

歡迎貢獻代碼！請遵循以下步驟：

1. 遵循現有的代碼模式
2. 為新功能添加測試
3. 更新文檔
4. 確保 npm test 和 npm run standards 通過

📄 許可證

MIT © hypothesi