SuperAPI AI 工具集

tauri-mcp-bridge

智能体与模型

查看项目

更新于 10-16 07:19

技能介绍

用途:为 AI 智能体与运行中的 Tauri v2 应用之间建立实时交互通道,使智能体能够观察并操作桌面/移动端 Tauri 应用的 WebView 界面与后端命令。

架构:必须同时安装两部分。第一部分是 Node.js MCP 服务器(npm 包 @hypothesi/tauri-mcp-server),运行在 AI 客户端侧,向客户端暴露 20 个工具和 3 个斜杠命令,并通过 WebSocket 与插件通信。第二部分是 Rust 插件(crate: tauri-plugin-mcp-bridge),运行在 Tauri 应用内,启动 WebSocket 服务器(默认端口 9223,占用时可扫描至 9322),处理 IPC 监控、JS 执行、截图与窗口管理等命令。任何一侧单独安装都无法工作。

主要能力:UI 自动化与 WebView 工具支持截图、DOM/可访问性快照、获取计算样式、查找元素、点击/输入/滚动/悬停/清空/选择/聚焦、键盘按键、等待元素状态、执行任意 JavaScript、可视化元素选择器;窗口管理支持列出、查询与调整窗口尺寸;IPC 与插件工具支持调用任意已注册 Tauri 命令、启停 IPC 调用拦截、读取捕获的 IPC 事件、发射 Tauri 事件、获取后端状态与已注册插件;日志工具可读取 WebView 控制台、Android logcat、iOS 设备日志或系统日志。多数 WebView 工具接受 strategy 参数,可取值 css(默认)、xpath、text、aria-label、ref,其中 ref 可配合可访问性快照输出的引用 ID 定位元素。

使用方式:AI 客户端侧可用 npx -y install-mcp @hypothesi/tauri-mcp-server --client claude-code 自动安装,或手动在 MCP 配置文件中添加 mcpServers 配置,command 为 npx,args 为 -y 与包名;配置后必须完全退出并重启 AI 客户端。Rust 插件侧执行 cd src-tauri && cargo add tauri-plugin-mcp-bridge,在 lib.rs 或 main.rs 的 builder 中以 #[cfg(debug_assertions)] 条件注册 tauri_plugin_mcp_bridge::init(),并可通过 Builder::new() 自定义 bind_address 与 base_port。使用任何其他工具前,必须先调用 driver_session 且 action 为 "start"。

适用场景与限制:适合在开发调试阶段让 AI 智能体实时观察和操作 Tauri v2 应用界面、验证前端交互、检查 IPC 调用与日志。需在 debug 构建下启用,生产环境通常不启用;文档未提供收费、价格等商业信息。部分功能(如 Android/iOS 日志)需连接设备或模拟器。以上为资料所述内容,未提及的细节暂未提供。