Mcp-worker

Mcp-worker は、公開 MCP サーバーとアウトバウンド専用のワーカー接続を通じて、ChatGPT がポリシー制御された 1 台の Windows マシンを操作できるようにします。

リポジトリには 3 つの部分が含まれています:

• src/remote: Streamable HTTP MCP サーバーと永続的なリレー API

• src/worker: アウトバウンドのワーカークライアントと正確なアクション承認ブリッジ

• packages/windows-worker: 完全な Windows ツール、ポリシー、監査、デスクトップ、クリップボード、プロセス、転送、管理、および .NET ヘルパーの実装

リモートサーバーは、ワーカーがオフラインの場合でも、完全な 31 ツールのカタログをアドバタイズします。ツールの実行は、ワーカーのローカルポリシーに従います。プロンプトの決定には、MCP エリシテーションと、正確なリクエストにバインドされた短命のチケットを使用します。

動作するもの

• OAuth で保護された /mcp と、個別に認証されたワーカーエンドポイント

• SQLite ジョブ、リース、有効期限、重複排除された結果、キャンセル、および不確定な変更の処理

• ファイル CRUD と検索、プロセス実行と対話型セッション、デスクトップおよびクリップボードツール

• 同梱の .NET 10 ヘルパーによる AppContainer 実行

• 期限切れ MCP リソースによるファイルインポートとチャンク化されたファイルエクスポート

• リレー相関 ID を持つローカル SQLite 監査レコード

• 非表示実行、再起動動作、および制限付きログを備えた現在のユーザー向けスケジュールタスクスクリプト

• CI での Linux リレーテスト、Windows ワーカーテスト、およびネイティブヘルパービルド

Related MCP server: Secure Local AI Agent MCP

ローカル検証

npm install
npm run build
npm test
npm run test:windows
npm run native:build

各プロセスを開始する前に、.env.example を各プロセスの環境にコピーします。リモートサービスは npm run remote で、Windows クライアントは npm run worker で実行します。

公開デプロイには、このリポジトリから推測できない選択が依然として必要です: ドメインと DNS の制御、イングレス、管理者サポート、OAuth 登録、サービスアカウント、永続ディレクトリ、バックアップとログのポリシー、アラート、サイズ制限。 docs/operations.md を参照してください。

ドキュメント

• アーキテクチャと信頼境界

• セットアップ、デプロイ、バックアップ、ロールバック、および所有者の決定

• 元のワーカーインベントリ