WinBridgeAgent

WinBridgeAgent

中文文档

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

WinBridgeAgent Pro（無料ダウンロード）

オープンソース版に加えて、WinBridgeAgent Proも無料でダウンロードできるようになりました。

Pro版は、より包括的なWindowsエージェント／ノード環境を必要とするユーザー向けに設計されており、より本番環境に適したWindowsノード（OpenClaw Nodeの使用感に近いもの）の実現に向けて、継続的に改善されています。

現在取り組んでいる主な機能強化は次のとおりです。

• メディア機能の強化：カメラでの写真・動画撮影、画面録画
• システム連携の深化：通知、位置情報、オーディオなどのOS機能
• 自動化機能の強化：権限・安全性の制御を備えたシェルコマンド実行の拡充
• 本番環境への対応力向上：タイムアウト処理、リソースのクリーンアップ、エラー処理、安定性の改善

詳細の確認とダウンロードはこちら：

• https://codyard.dev/winbridgeagentpro

アーキテクチャ

+------------------------------------------------------+
|                Local Area Network (LAN)              |
|                                                      |
|   +--------------------+                             |
|   |   MCP Client       |                             |
|   | (OpenClaw / Agent) |                             |
|   |  - LLM reasoning   |                             |
|   |  - Tool planning   |                             |
|   +---------+----------+                             |
|             | MCP Protocol (HTTP/SSE)                |
|             |                                        |
|   +---------v------------------------------------+   |
|   |           Windows PC                          |   |
|   |                                              |   |
|   |   +--------------------------------------+   |   |
|   |   |  WinBridgeAgent                      |   |   |
|   |   |  (Local Tray MCP Server)             |   |   |
|   |   |                                      |   |   |
|   |   |  - MCP Server (localhost / LAN)      |   |   |
|   |   |  - Policy & Permission Guard         |   |   |
|   |   |  - Tool Execution Layer              |   |   |
|   |   |  - Audit & Logging                   |   |   |
|   |   +-----------+--------------------------+   |   |
|   |               |                              |   |
|   |      +--------v--------+                     |   |
|   |      | Windows System  |                     |   |
|   |      | APIs / Resources|                     |   |
|   |      | (FS / Screen /  |                     |   |
|   |      |  Clipboard /    |                     |   |
|   |      |  Process etc.)  |                     |   |
|   |      +-----------------+                     |   |
|   |                                              |   |
|   +----------------------------------------------+   |
|                                                      |
+------------------------------------------------------+

Optional External Dependencies:
- GitHub Releases (Auto Update)
- Optional Remote Services (APIs, Cloud tools)

機能

コア機能

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

ファイルとシステムの操作

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

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

• ウィンドウ管理：開いているすべてのウィンドウを詳細情報とともに一覧表示
• プロセスの照会：実行中のすべてのプロセスを詳細情報とともに一覧表示
• プロセス管理：プロセスの終了、優先度の変更（保護対象プロセスのブロックリスト付き）
• コマンドの実行：システムコマンドを実行し、出力を取得

電源管理

• シャットダウン：遅延、強制、カスタムメッセージに対応
• 再起動：遅延、強制に対応
• 休止状態とスリープ：システムを休止状態またはスリープに移行
• シャットダウンのキャンセル：予約済みのシャットダウン／再起動をキャンセル

自動更新

• バージョン確認：GitHubリリースを自動確認
• 更新通知：分かりやすい通知ダイアログ
• ワンクリックダウンロード：GitHubリリースページを開く
• 複数の更新チャネル：StableおよびBetaチャネル
• 多言語対応：簡体字中国語、英語

システム要件

• Windows 10/11（x64、x86、ARM64）
• 追加のランタイム依存関係はありません

クイックスタート

MCP Registry からインストール

WinBridgeAgent は MCP Registry に io.github.codyard/winbridgeagent として公開されています。レジストリに対応した MCP クライアントから直接インストールできます。

手動インストール

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

OpenClaw と Windows ノードのセットアップについては、windows-node-install.en.md を参照してください。

MCP クライアントの設定

WinBridgeAgent は、MCP 互換の任意のクライアントで動作します。以下に、よく使われるクライアントのセットアップ手順を示します。

注：WinBridgeAgent を実行している Windows PC の IP アドレスで <windows-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

mcporter のペアリングを含む、Windows ノードのデプロイ手順については、windows-node-install.en.md を参照してください。

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 エンドポイントに直接アクセスできます。

エンドポイント

メソッド	パス	説明
GET	/	API エンドポイント一覧
GET	/health	ヘルスチェック
GET	/status	サーバーのステータスと情報
GET	/disks	すべてのディスクドライブを一覧表示
GET	/list?path=<path>	ディレクトリの内容を一覧表示
GET	/read?path=<path>	ファイルの内容を読み取る
GET	/search?path=<path>&query=<q>	ファイルの内容を検索
GET	/clipboard	クリップボードを読み取る
PUT	/clipboard	クリップボードに書き込む
GET	/screenshot	スクリーンショットを撮影
GET	/windows	すべてのウィンドウを一覧表示
GET	/processes	すべてのプロセスを一覧表示
POST	/execute	コマンドを実行
GET	/exit	サーバーをシャットダウン
POST	/mcp/initialize	MCP を初期化
POST	/mcp/tools/list	MCP ツールを一覧表示
POST	/mcp/tools/call	MCP ツールを呼び出す

例

以下の <windows-ip> は、実際の Windows PC の IP アドレスに置き換えてください（同じマシンでテストする場合は localhost を使用してください）。

# Server status
curl http://<windows-ip>:35182/health

# List disks
curl http://<windows-ip>:35182/disks

# List directory
curl "http://<windows-ip>:35182/list?path=C:\\"

# Read file
curl "http://<windows-ip>:35182/read?path=C:\\test.txt"

# Search file content
curl "http://<windows-ip>:35182/search?path=C:\\test.txt&query=keyword"

# Read clipboard
curl http://<windows-ip>:35182/clipboard

# Write clipboard
curl -X PUT -H "Content-Type: application/json" \
  -d '{"content":"Hello World"}' http://<windows-ip>:35182/clipboard

# Take screenshot
curl http://<windows-ip>:35182/screenshot

# List windows
curl http://<windows-ip>:35182/windows

# List processes
curl http://<windows-ip>:35182/processes

# Execute command
curl -X POST -H "Content-Type: application/json" \
  -d '{"command":"echo Hello"}' http://<windows-ip>:35182/execute

# MCP: Initialize
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: List tools
curl -X POST -H "Content-Type: application/json" \
  -d '{}' http://<windows-ip>:35182/mcp/tools/list

# MCP: Call tool
curl -X POST -H "Content-Type: application/json" \
  -d '{"name":"list_windows","arguments":{}}' \
  http://<windows-ip>:35182/mcp/tools/call

# Shutdown server
curl http://<windows-ip>:35182/exit

If you have multiple computers with WinBridgeAgent installed on your LAN, configure your MCP client to manage them:

```json
{
    "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"
        }
    }
}

詳しくは、複数コンピューターのセットアップガイド を参照してください。

設定

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

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

Key	説明	デフォルト
server_port	サーバーの待ち受けポート	35182
auto_port	使用中の場合にポートを自動選択	true
listen_address	0.0.0.0（LAN）または 127.0.0.1（ローカルのみ）	0.0.0.0
language	UI 言語（en / zh-CN）	en
auto_startup	Windows の起動時に開始	false
daemon_enabled	デーモンのウォッチドッグを有効化	true

ソースからのビルド

前提条件

• macOS（Apple Silicon または Intel）
• CMake 3.20+
• MinGW-w64 クロスコンパイルツールチェーン

依存関係のインストール

brew install mingw-w64 cmake

ビルド

# Build all architectures
./scripts/build.sh

# Or build a single architecture manually
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++ source code
├── include/        # Public headers
├── resources/      # Runtime assets and templates
├── scripts/        # Build, test, release scripts
├── docs/           # Documentation
├── tests/          # Test code
├── third_party/    # Vendored dependencies
└── build/          # Build outputs

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

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

ライセンス

このプロジェクトは、GNU 一般公衆利用許諾書 v3.0 の下でライセンスされています。

Copyright © 2026 WinBridgeAgent Contributors