MCP Server Tauri

🚀 MCP Server Tauri

Tauri開発において、AIアシスタントに超能力を付与します

ドキュメント · クイックスタート · 利用可能なツール

このModel Context Protocol (MCP)サーバーは、Claude、Cursor、WindsurfなどのAIアシスタントがTauri v2アプリケーションの構築、テスト、デバッグを行えるようにします。実行中のアプリからのスクリーンショット、DOM状態、コンソールログをAIに提供することで、AIはアプリの状況を理解し、操作するための情報を得ることができます。

✨ 主な機能

免責事項: このMCPはエージェント型コーディングツールを使用して開発されています。バグが含まれている可能性があります。

🚀 クイックスタート

前提条件

• Node.js 20以上とnpm
• RustとCargo (Tauri開発用)
• Tauri CLI: npm install -g @tauri-apps/cli@next
• モバイル開発の場合: Xcode (macOS)またはAndroid SDK

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

Rustクレートを追加する:

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サーバーはアプリケーションのウェブビューとやり取りできません。

注意: 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アシスタント                             │
│                  (Claude, Cursor, Windsurf)                     │
└─────────────────────────┬───────────────────────────────────────┘
                          │ MCPプロトコル (stdio)
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                     MCPサーバー (Node.js)                        │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────┐   │
│  │   マネージャー    │  │    ドライバー    │  │      モニター         │   │
│  │  CLI/設定  │  │ UI自動化│  │   ログ/IPCイベント    │   │
│  └──────────────┘  └──────┬───────┘  └──────────────────────┘   │
└─────────────────────────────┼───────────────────────────────────┘
                              │ WebSocket (ポート9223)
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      Tauriアプリケーション                          │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │              MCPブリッジプラグイン (Rust)                    │   │
│  │         IPCコマンド • イベント • バックエンド状態            │   │
│  └──────────────────────────────────────────────────────────┘   │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │                    ウェブビュー (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ブリッジプラグイン — Tauriプラグインのドキュメント

🤝 コントリビューション

コントリビューションは大歓迎です！以下のことをお願いします:

1. 既存のコードパターンに従ってください
2. 新機能にはテストを追加してください
3. ドキュメントを更新してください
4. npm testとnpm run standardsが通ることを確認してください

📄 ライセンス

MIT © hypothesi