Windows環境で動作するセキュリティ分離型リモート開発MCP(Model Context Protocol)サーバーです。
ChatGPT、ClaudeなどMCPをサポートするLLMクライアントと接続し、実際のWindows開発環境のファイル、ターミナル、プロセス、ブラウザ、複数のWorkspaceを対話的に操作できます。
また、Godot、Blenderなど別のRemote MCPをProviderとして接続できるため、1つのGatewayでさまざまな開発ツールを一緒に使用できます。
WSRが役に立った場合は、GitHub Sponsorsを通じてプロジェクトを支援できます。
支援はWSRのメンテナンスと、新しいMCP Providerおよび機能開発に使用されます。
Windows SandboxGuard — 設定したWorkspace境界内でファイルとコマンド実行を制限します。
Multi-Workspace — 複数のプロジェクトを登録し、アクティブなWorkspaceを切り替えられます。
ファイル/コード管理 — 参照、作成、修正、移動、コピー、削除、patch適用などをサポートします。
PowerShell / CMD / プロセス管理 — 開発コマンドの実行とバックグラウンドプロセスを管理します。
Playwrightブラウザ自動化 — 実際のブラウザを開き、ナビゲーション、入力、クリック、スクリーンショットなどを実行します。
Remote MCP Provider — Godot、Blenderなど任意のMCPをGatewayに追加できます。
Provider障害分離 — 1つのMCPが停止していても、WSR Coreと他のProviderは引き続き使用できます。
Provider Scheduler — MCPの接続状態とtools/listを定期的に確認し、自動再接続とTool Registryの更新を実行します。
OAuth 2.1 / Cloudflare Tunnelサポート — リモートMCPクライアントと安全に接続できる構成を提供します。
MCP 2026-07-28 + legacy互換 — server/discoverベースの最新statelessリクエストと2025 initializeフローを同じ/mcpエンドポイントでサポートします。
Related MCP server: local-mcp
ChatGPT / Claude
│
MCP / HTTPS
│
Cloudflare Tunnel
│
▼
Windows Scoped Remote MCP Server
│
┌─────────────────┼─────────────────┐
│ │ │
Workspace Playwright Providers
│ │ │
Files / Process Browser tools ┌────┼─────┐
│ │ │
Godot Blender ...
│ │
godot_* blender_*WSR自体はGatewayの役割を果たし、外部MCPはRemoteMcpProviderを通じて接続します。
HTTP MCPレイヤーは公式TypeScript SDK v2のcreateMcpHandlerを使用します。2026-07-28クライアントにはserver/discoverとリクエストごとの_meta envelopeを提供し、既存クライアントには同じtool定義で2025-era stateless initialize fallbackを提供します。
POST /mcp
├─ MCP 2026-07-28 → server/discover / per-request envelope
└─ MCP 2025-era → initialize / notifications/initializedユーザーごとに必要なMCPが異なるため、WSRは特定のMCP一つに依存しません。
例えば:
WSR
├── Godot MCP
├── Blender MCP
├── Playwright
└── 사용자가 추가한 MCP各Providerにはnamespaceを使用します。
MCP | Namespace例 |
Godot |
|
Blender |
|
Browser |
|
新しいMCP |
|
例えばBlender MCPのget_sceneは、WSRではblender_get_sceneとして公開されます。
プロジェクトを取得した後、ChatGPTに次のように依頼できます。
이 windows-scoped-remote-mcp-server 프로젝트에 Blender MCP를 추가해줘.
AGENT.md와 skills/add-remote-mcp-provider/SKILL.md를 먼저 읽고
기존 RemoteMcpProvider / ProviderRegistry 구조를 따라 작업해줘.
Blender MCP의 연결 방법과 필요한 설정을 확인하고
blender_* namespace를 사용해줘.
테스트와 문서도 업데이트하고 typecheck와 전체 테스트까지 실행해줘.詳細な手順はskills/add-remote-mcp-provider/SKILL.mdを参照してください。
Remote MCPはオプションの依存関係です。
Godot MCP OFF
│
▼
Godot Provider = unavailable
│
├── WSR Core → 계속 사용 가능
├── Playwright → 계속 사용 가능
└── 다른 Provider → 계속 사용 가능Provider接続の失敗によってWSR全体が終了することはありません。
Provider固有のtoolを呼び出したときに接続されていない場合は、明確なエラーを返します。
MCP provider 'godot' (godot) is not connected.
Start the godot MCP server/editor and try again.現在の状態はmcp_provider_status toolで確認できます。
WSRはProviderSchedulerをバックグラウンドで実行し、Remote MCPの状態を継続的に管理します。
ProviderScheduler
│
┌─────────────┴─────────────┐
▼ ▼
CONNECTED UNAVAILABLE
│ │
tools/list reconnect
│ │
변경 여부 확인 tools/list
│ │
└─────────────┬─────────────┘
▼
Tool Registry 갱신デフォルト値:
接続済みProviderのヘルスチェック: 10秒
未接続Providerのリトライ: 5秒
環境変数で変更できます。
MCP_PROVIDER_HEALTH_INTERVAL_MS=10000
MCP_PROVIDER_RETRY_INTERVAL_MS=5000WSR 실행
↓
Godot OFF
↓
Provider unavailable
↓
Godot 실행
↓
Scheduler가 자동 발견
↓
tools/list
↓
godot_* Tool Registry 갱신したがって、Providerを起動または再実行するためにWSR自体を再起動する必要はありません。
Remote MCPのTool定義が変更されると、tools/listの結果を比較してRegistryスナップショットも更新します。
現在のHTTPレイヤーはMCPリクエストごとにServerを構成する構造のため、次のtools/listリクエストに最新のTool Registryが反映されます。長期セッションでクライアントUIまで即時通知を送るtools/list_changed notificationは、今後のセッション管理構造とともに拡張できます。
複数のプロジェクトを1つのWSRで管理できます。
MCP_WORKSPACE_ROOTS=game:D:\Godot\MyGame,tools:D:\project\tools,reference:D:\project\reference
MCP_WORKSPACE_ROOT=D:\Godot\MyGame現在のアクティブWorkspaceをデフォルトの作業対象として使用し、他の登録WorkspaceはクロスWorkspace機能を通じて読み取り/検索/分析/コピー中心で使用できます。
Workspace境界を超えたファイルおよびコマンドへのアクセスはSandboxGuardがブロックします。
Playwrightが統合されており、実際のブラウザをMCPを通じて操作できます。
ChatGPT
↓
"브라우저에서 페이지를 열고 버튼을 눌러줘"
↓
WSR
↓
Playwright
↓
실제 브라우저サポート例:
URL移動
要素クリック
入力/フォーム作成
キーボード入力
ページ内容の参照
JavaScript評価
スクリーンショット
ブラウザセッション管理
git clone <repository-url>
cd windows-scoped-remote-mcp-server
npm install
copy .env.example .env
npm run build
npm testWindowsではstart.batを使用する方法もサポートしています。
start.bat変数 | デフォルト値 | 説明 |
|
| WSR HTTPサーバーポート |
| 現在のパス | アクティブWorkspace |
|
| Multi-Workspaceリスト |
| なし | 認証用トークン |
| なし | 公開MCP URL |
| なし | Cloudflare Tunnelトークン |
|
| Playwright Headless有無 |
|
| 接続済みProvider検査間隔(ms) |
|
| 未接続Provider再接続間隔(ms) |
|
| Godot MCP Provider有効化 |
|
| Godot MCP endpoint |
機密トークンとパスワードは.envにのみ保存し、Gitにコミットしないでください。
npm run typecheck
npm test
npm run buildMCP SDKはv2 split package構造を使用します。
サーバーおよびcreateMcpHandler: @modelcontextprotocol/server
Node/Express adapter: @modelcontextprotocol/node
Remote Provider client: @modelcontextprotocol/client
既存の組み込みOAuth Authorization Server互換レイヤー: @modelcontextprotocol/server-legacy/auth
最後の項目は公式v1→v2マイグレーションブリッジであり、deprecated状態です。discovery復旧と既存OAuth動作の保存のために維持しますが、長期的には専用のOAuth/IdPライブラリに分離する必要があります。
新しいMCP Providerを追加する際は、次のドキュメントを先に読むことをお勧めします。
AGENT.md — プロジェクト作業ルール
docs/mcp-gateway-architecture.md — Gateway / Provider構造
skills/add-remote-mcp-provider/SKILL.md — MCP追加手順
skills/test-mcp-provider/SKILL.md — Providerテスト
skills/debug-mcp-gateway/SKILL.md — MCP問題解決
現在WSRはGodot MCPと実際に接続し、次の作業を検証しました。
ChatGPT
↓
WSR
↓
Godot MCP
↓
Godot Editor
↓
Scene 생성 / 수정 / 저장テストScene:
res://mcp_test.tscn
McpTest (Node3D)
├── TestCube (MeshInstance3D)
├── Camera3D
└── DirectionalLight3Dこのフローは、WSRが単純なファイルMCPではなく、実際の開発ツールを接続するGatewayであることを示す代表的なテスト事例です。
WSRは開発自動化のために強力な機能を提供するため、次の原則を重要視しています。
Workspace外部へのアクセスをSandboxGuardで制限します。
他のWorkspaceを変更しないよう、クロスWorkspace権限を分離します。
認証トークンとCloudflare Tunnelトークンをソースコードに保存しません。
セキュリティ機能を絶対的な安全保証として表現せず、設定された境界と権限モデルに基づいて説明します。
リモートMCP Provider1つの障害がGateway全体の障害につながらないよう分離します。
MIT License
<<<<<<< HEAD
WSRはRemote MCP Providerごとにtransportを選択できます。現在検証済みの構成は次のとおりです。
bc801171f3701eb530b6adcc49612293e251de7e
Provider | Endpoint | Transport | Tools |
Godot |
| Streamable HTTP | 45 |
PostgreSQL (CrystalDBA postgres-mcp) |
| legacy SSE | 9 |
.envに次の値を設定します。PostgreSQL Providerを有効にするには、ルート.envに次の値を設定します。
bc801171f3701eb530b6adcc49612293e251de7e
MCP_POSTGRESQL_ENABLED=true
MCP_POSTGRESQL_URL=http://127.0.0.1:10021/sse<<<<<<< HEAD
Docker実行環境はmcp-servers/postgres-mcp/にあり、実際のDATABASE_URIはそのディレクトリの.envにのみ置きます。DBパスワードや実際の接続文字列はGitにコミットしません。
PostgreSQL MCPが提供する9つのツールは、WSR namespace適用後にpostgresql_*の形式で公開されます。実際の接続ではlist_schemas、list_objects、get_object_details、explain_query、analyze_workload_indexes、analyze_query_indexes、analyze_db_health、get_top_queries、execute_sqlを確認しました。
docs/postgresql-mcp-provider.mdとmcp-servers/postgres-mcp/README.mdを参照してください。Docker実行環境はmcp-servers/postgres-mcp/にあり、実際のDATABASE_URIはそのディレクトリの.envにのみ置きます。DBパスワードや実際の接続文字列はGitにコミットしません。
PostgreSQL MCPが提供する9つのツールは、WSR namespace適用後にpostgresql_*の形式で公開されます。実際の接続ではlist_schemas、list_objects、get_object_details、explain_query、analyze_workload_indexes、analyze_query_indexes、analyze_db_health、get_top_queries、execute_sqlを確認しました。
詳細なインストール/運用方法はdocs/postgresql-mcp-provider.mdとmcp-servers/postgres-mcp/README.mdを参照してください。
bc801171f3701eb530b6adcc49612293e251de7e
This server cannot be deployed
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Persistent cloud workspaces for AI agents: run commands, edit files, use git and a browser.
Secure AI access to Windows, macOS, Linux computers and a hosted Cloud Browser.
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
