mcp-server-tauri

@hushlor/tauri-mcp-server

Claude、Cursor、Windsurf などの AI アシスタントが Tauri® v2 アプリケーションの構築、テスト、デバッグを行えるようにする Model Context Protocol（MCP）サーバーです。

📖 完全なドキュメント

独立した下流フォーク： Hushlor は、上流の hypothesi/mcp-server-tauri とは独立してこのディストリビューションを管理し、上流の MIT ライセンスと帰属表示を維持しています。

機能

カテゴリ	機能
🎯 UI 自動化	スクリーンショット、クリック、入力、スクロール、要素の検索、ビジュアル要素ピッカー
🔍 IPC モニタリング	Tauri IPC 呼び出しをリアルタイムでキャプチャして検査
📱 モバイル開発	Android エミュレーターと iOS シミュレーターの一覧表示
📋 ログ	コンソール、Android logcat、iOS、システムログのストリーミング

クイックスタート

1. Tauri アプリに MCP Bridge プラグインを追加する

cargo add tauri-plugin-hushlor-mcp-bridge --rename tauri-plugin-mcp-bridge --version 0.14.0

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

注： npm パッケージ @hushlor/tauri-plugin-mcp-bridge は任意です。必要なのは、アプリのフロントエンドコードからプラグインを呼び出す場合のみです。MCP サーバーは WebSocket 経由で Rust プラグインと直接通信します。

2. AI アシスタントを設定する

aix を使って、サーバーを AI アシスタントに追加します。

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

対応クライアント：claude-code、cursor、windsurf、vscode、cline、roo-cline、claude、zed、goose、warp、codex

ターミナル CLI

シェルから同じツールを直接呼び出す場合は、付属の CLI パッケージをインストールします。

npm install -g @hushlor/tauri-mcp-cli
tauri-mcp driver-session start --port 9223
tauri-mcp driver-session status --json

CLI はバックグラウンドで基盤となる MCP サーバーを起動状態に保つため、driver_session などの状態を持つコマンドを別々の実行間でも使用できます。

複数アプリのサポート

MCP サーバーは複数の Tauri アプリへの同時接続をサポートしています。各アプリは一意のポートで実行され、最後に接続されたアプリが「デフォルト」アプリになります。

主な機能：

• 異なるポート上の複数アプリに接続
• appIdentifier が指定されていない場合はデフォルトアプリを使用
• ポート番号またはバンドル ID を使用して特定のアプリを指定
• 個別のセッションまたはすべてのセッションを一括で停止

使用例：

// Connect to first app
await driver_session({ action: "start", port: 9223 })

// Connect to second app
await driver_session({ action: "start", port: 9224 })

// Check status - shows both apps with default indicator
await driver_session({ action: "status" })

// Use default app (most recent - port 9224)
await webview_screenshot()

// Target specific app by port
await webview_screenshot({ appIdentifier: 9223 })

// Stop specific app
await driver_session({ action: "stop", appIdentifier: 9223 })

// Stop all apps
await driver_session({ action: "stop" })

利用可能なツール（全22種類）

セットアップと設定

ツール	説明
get_setup_instructions	MCP Bridge プラグインのセットアップ／更新手順を取得

UI 自動化

ツール	説明
driver_session	自動化セッションの開始／停止／状態確認
webview_find_element	CSS セレクター、XPath、テキスト、または ref ID で要素を検索
read_logs	コンソール、Android、iOS、またはシステムログを読み取る
webview_interact	クリック、スクロール、スワイプ、フォーカス、長押し
webview_screenshot	WebView のスクリーンショットをキャプチャ（デフォルトは JPEG）
native_dialog_snapshot	アプリ所有のネイティブ Windows ダイアログの連鎖とナビゲーションコントロールを検査
native_dialog_interact	ネイティブ Windows ダイアログのコントロールを実行、パス設定、または選択
webview_keyboard	テキストを入力、またはキーイベントを送信
webview_wait_for	要素、テキスト、またはイベントを待機
webview_get_styles	計算済み CSS スタイルを取得
webview_execute_js	WebView 内で JavaScript を実行
webview_dom_snapshot	構造化 DOM スナップショットを取得（アクセシビリティまたは構造）
webview_select_element	ビジュアル要素ピッカー — ユーザーが要素をクリックし、メタデータとスクリーンショットを返す
webview_get_pointed_element	ユーザーが Alt+Shift+クリックした要素のメタデータを取得
manage_window	ウィンドウの一覧表示、情報の取得、またはサイズ変更

IPC とプラグイン

ツール	説明
ipc_execute_command	Tauri IPC コマンドを実行します
ipc_get_backend_state	アプリのメタデータと状態を取得します
ipc_monitor	IPC の監視を開始／停止します
ipc_get_captured	キャプチャした IPC トラフィックを取得します
ipc_emit_event	カスタムイベントを発行します

モバイル開発

ツール	説明
list_devices	Android デバイスと iOS シミュレーターの一覧を表示します

リンク

• ドキュメント
• GitHub リポジトリ
• MCP Bridge プラグイン（crates.io）
• 変更履歴

ライセンス

MIT © Hushlor。元の上流プロジェクトの著作権表示と帰属表示はパッケージの LICENSE で保持されています。由来については、hypothesi/mcp-server-tauri を参照してください。

---

商標に関する通知

TAURI® は、Commons Conservancy 内の The Tauri Programme の登録商標です。https://tauri.app/

このプロジェクトは、Commons Conservancy 内の The Tauri Programme とは提携しておらず、同組織から承認または後援を受けていません。