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