Winbridgeagent

🚀 WinBridgeAgent

WinBridgeAgentは、Model Context Protocol (MCP) 標準を実装したオープンソースのWindowsローカル機能サービスです。Claude DesktopやOpenAIなどのAIアシスタントに対して、追跡可能なWindowsシステム操作を提供します。

🚀 クイックスタート

MCPレジストリからのインストール

WinBridgeAgentは、MCPレジストリに io.github.codyard/winbridgeagent として公開されています。レジストリをサポートするMCPクライアントは、直接インストールできます。

手動インストール

1. GitHub Releases から最新のリリースをダウンロードします。
2. WinBridgeAgent-x64.exe (64-bit) または WinBridgeAgent-x86.exe (32-bit) を実行します。
3. プログラムがシステムトレイに表示されます。
4. MCPクライアントを設定します（以下を参照）。

OpenClaw + Windowsノードのセットアップについては、 を参照してください。

✨ 主な機能

コア機能

• MCPプロトコル：完全なModel Context Protocolの実装
• UTF-8互換性：MCPツールの出力はUTF-8でエンコードされ、非ASCIIのWindowsパスもサポート
• HTTP API：リモート制御のためのHTTPインターフェース
• リアルタイム監視：リクエスト/レスポンスをリアルタイムで表示するダッシュボードウィンドウ
• 監査ログ：完全な操作ログ記録
• システムトレイ：便利なグラフィカル管理インターフェース
• 柔軟な設定：0.0.0.0と127.0.0.1のリスンアドレスを切り替え可能
• 自動更新：GitHubのリリースを自動チェックし、ワンクリックでダウンロード

ファイルとシステム操作

• ファイル読み取り：ディスク列挙、ディレクトリリスト、ファイル読み取り（行範囲指定）、内容検索
• ファイル操作：削除、コピー、移動、ディレクトリ作成
• クリップボード：HTTP APIを介してクリップボードの内容を読み書き（テキスト、画像、ファイル）
• スクリーンショット：
  • 全画面（HTTP API、PNG/JPEG）
  • ウィンドウキャプチャ（MCPツール、ウィンドウタイトル指定）
  • 領域キャプチャ（MCPツール、座標指定）

プロセスとウィンドウ管理

• ウィンドウ管理：開いているすべてのウィンドウを詳細とともにリスト表示
• プロセスクエリ：実行中のすべてのプロセスを詳細とともにリスト表示
• プロセス管理：プロセスを終了、優先度を調整（保護されたプロセスのブロックリストあり）
• コマンド実行：システムコマンドを実行し、出力を取得

電源管理

• シャットダウン：遅延、強制、カスタムメッセージ付き
• 再起動：遅延、強制
• ハイバネートとスリープ：システムのハイバネートとスリープ
• シャットダウンのキャンセル：予定されたシャットダウン/再起動をキャンセル

自動更新

• バージョンチェック：GitHubのリリースを自動チェック
• 更新通知：分かりやすい通知ダイアログ
• ワンクリックダウンロード：GitHubのリリースページを開く
• 複数チャンネル：安定版とベータ版チャンネル
• 多言語対応：簡体字中国語、英語

📦 インストール

前提条件

• Windows 10/11 (x64, x86, ARM64)
• 追加のランタイム依存関係はありません。

MCPレジストリからのインストール

WinBridgeAgentは、MCPレジストリに io.github.codyard/winbridgeagent として公開されています。レジストリをサポートするMCPクライアントは、直接インストールできます。

手動インストール

1. GitHub Releases から最新のリリースをダウンロードします。
2. WinBridgeAgent-x64.exe (64-bit) または WinBridgeAgent-x86.exe (32-bit) を実行します。
3. プログラムがシステムトレイに表示されます。
4. MCPクライアントを設定します（以下を参照）。

💻 使用例

基本的な使用法

# サーバーの状態を確認
curl http://<windows-ip>:35182/health

# ディスクをリスト表示
curl http://<windows-ip>:35182/disks

# ディレクトリをリスト表示
curl "http://<windows-ip>:35182/list?path=C:\\"

# ファイルを読み取り
curl "http://<windows-ip>:35182/read?path=C:\\test.txt"

# ファイル内容を検索
curl "http://<windows-ip>:35182/search?path=C:\\test.txt&query=keyword"

# クリップボードを読み取り
curl http://<windows-ip>:35182/clipboard

# クリップボードに書き込み
curl -X PUT -H "Content-Type: application/json" \
  -d '{"content":"Hello World"}' http://<windows-ip>:35182/clipboard

# スクリーンショットを撮影
curl http://<windows-ip>:35182/screenshot

# ウィンドウをリスト表示
curl http://<windows-ip>:35182/windows

# プロセスをリスト表示
curl http://<windows-ip>:35182/processes

# コマンドを実行
curl -X POST -H "Content-Type: application/json" \
  -d '{"command":"echo Hello"}' http://<windows-ip>:35182/execute

# MCP: 初期化
curl -X POST -H "Content-Type: application/json" \
  -d '{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}' \
  http://<windows-ip>:35182/mcp/initialize

# MCP: ツールをリスト表示
curl -X POST -H "Content-Type: application/json" \
  -d '{}' http://<windows-ip>:35182/mcp/tools/list

# MCP: ツールを呼び出し
curl -X POST -H "Content-Type: application/json" \
  -d '{"name":"list_windows","arguments":{}}' \
  http://<windows-ip>:35182/mcp/tools/call

# サーバーをシャットダウン
curl http://<windows-ip>:35182/exit

高度な使用法

LAN内に複数のWinBridgeAgentがインストールされたコンピュータがある場合、MCPクライアントを設定して管理できます。

{
    "mcpServers": {
        "winbridge-test": {
            "url": "http://192.168.31.3:35182",
            "description": "Test PC"
        },
        "winbridge-office": {
            "url": "http://192.168.31.4:35182",
            "description": "Office PC"
        }
    }
}

詳細は Multi-Computer Setup Guide を参照してください。

📚 ドキュメント

MCPクライアントの設定

WinBridgeAgentは、MCP互換のクライアントと連携します。以下は、人気のクライアントの設定手順です。

⚠️ 重要提示

<windows-ip> を、WinBridgeAgentが実行されているWindows PCのIPアドレスに置き換えてください（例: 192.168.1.100）。MCPクライアントが同じWindowsマシン上で実行されている場合のみ、localhost を使用してください。

Claude Desktop

claude_desktop_config.json を編集します。

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "winbridgeagent": {
            "url": "http://<windows-ip>:35182",
            "transport": "http"
        }
    }
}

Cursor

1. Settings → MCP を開きます。
2. Add new MCP server をクリックします。
3. 以下を入力します。
   • Name: winbridgeagent
   • Type: http
   • URL: http://<windows-ip>:35182

または、プロジェクトのルートディレクトリの .cursor/mcp.json を編集します。

{
    "mcpServers": {
        "winbridgeagent": {
            "url": "http://<windows-ip>:35182",
            "transport": "http"
        }
    }
}

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。

{
    "mcpServers": {
        "winbridgeagent": {
            "serverUrl": "http://<windows-ip>:35182"
        }
    }
}

OpenClaw

1. Settings → MCP Servers を開きます。
2. Add をクリックします。
3. 以下を設定します。
   • Name: winbridgeagent
   • Transport: HTTP
   • URL: http://<windows-ip>:35182

Windowsノードのデプロイのステップバイステップガイド（mcporter のペアリングを含む）については、 を参照してください。

Cherry Studio

1. Settings → MCP Servers を開きます。
2. Add Server をクリックします。
3. Streamable HTTP タイプを選択します。
4. URLを http://<windows-ip>:35182 に設定します。

Cline (VS Code)

VS Codeの設定内の cline_mcp_settings.json を編集します。

{
    "mcpServers": {
        "winbridgeagent": {
            "url": "http://<windows-ip>:35182",
            "transportType": "http"
        }
    }
}

汎用MCPクライアント

HTTPトランスポートをサポートする任意のMCPクライアントは、以下を使用して接続できます。

• サーバーURL: http://<windows-ip>:35182
• トランスポート: HTTP (Streamable HTTP)
• プロトコルバージョン: 2024-11-05

HTTP API

サーバーは、設定されたポート（デフォルトは35182）でリッスンします。

⚠️ 重要提示

オープンソース版では、Bearer Token認証は必要ありません。すべてのAPIエンドポイントに直接アクセスできます。

エンドポイント

設定

初回実行時に config.json ファイルが自動生成されます。

{
    "server_port": 35182,
    "auto_port": true,
    "listen_address": "0.0.0.0",
    "language": "en",
    "auto_startup": false,
    "daemon_enabled": true
}

ソースからのビルド

前提条件

• macOS (Apple SiliconまたはIntel)
• CMake 3.20以上
• MinGW-w64クロスコンパイルツールチェーン

依存関係のインストール

brew install mingw-w64 cmake

ビルド

# すべてのアーキテクチャをビルド
./scripts/build.sh

# または、手動で単一のアーキテクチャをビルド
mkdir -p build/x64
cd build/x64
cmake ../.. -DCMAKE_TOOLCHAIN_FILE=../../toolchain-mingw-x64.cmake \
            -DCMAKE_BUILD_TYPE=Release
make -j$(sysctl -n hw.ncpu)

ビルド出力

• build/x64/WinBridgeAgent.exe — Windows x64
• build/x86/WinBridgeAgent.exe — Windows x86
• build/arm64/WinBridgeAgent.exe — Windows ARM64

プロジェクト構造

.
├── CMakeLists.txt
├── src/            # C++ソースコード
├── include/        # 公開ヘッダー
├── resources/      # ランタイムアセットとテンプレート
├── scripts/        # ビルド、テスト、リリーススクリプト
├── docs/           # ドキュメント
├── tests/          # テストコード
├── third_party/    # ベンダー依存関係
└── build/          # ビルド出力

セキュリティに関する注意事項

• リスンアドレス：0.0.0.0 を設定すると、LANからのアクセスが可能になります。ローカルのみの場合は 127.0.0.1 を使用してください。
• ファイアウォール：Windowsファイアウォールがネットワークアクセスをブロックする場合があります。必要に応じて例外を追加してください。
• 保護されたプロセス：システムに重要なプロセスは終了できません（system, csrss.exe, winlogon.exeなど）。
• 保護されたディレクトリ：システムディレクトリは削除できません（C:\Windows, C:\Program Filesなど）。
• 監査ログ：すべての操作がログに記録されます。

📄 ライセンス

このプロジェクトは、GNU General Public License v3.0 の下でライセンスされています。

Copyright © 2026 WinBridgeAgent Contributors