GPT Windows Connector

Удаленно-ориентированное, многопользовательское Windows-исполнение MCP для ChatGPT, Claude, Gemini и других MCP-совместимых AI-клиентов.

Продукт предоставляет доступ к локальным файлам проектов, Shell, долго работающим процессам, Git, автоматизации браузера и Windows desktop/UI Automation через VPS Gateway. Codex, Claude Code и Gemini CLI не используются в качестве уровня выполнения.

Итоговая архитектура

ChatGPT / Claude / Gemini / other Remote-MCP client
                    |
                    | HTTPS / MCP
                    v
              VPS Gateway
          account / projects / logs
                    |
                    | WSS
                    v
              Windows Node
                    |
        files / shell / git / browser / desktop

Весь трафик от AI к Windows ретранслируется через VPS. Windows-компьютер устанавливает исходящее WSS-соединение и не требует публичного входящего порта.

Related MCP server: pywinauto-mcp

Пользовательский опыт

1. Откройте веб-сайт VPS Gateway.

2. Зарегистрируйтесь с помощью email/пароля или войдите через Google.

3. Сопрягите Windows-компьютер из раздела Windows Nodes.

4. Создайте проект из раздела Projects.

5. Выберите онлайн Windows-компьютер.

6. Просмотрите разрешенное дерево папок этого компьютера и выберите рабочую область.

7. Подключите удаленную конечную точку MCP к AI-клиенту, используя ту же учетную запись.

8. AI использует ID проекта; VPS автоматически определяет правильного пользователя, Windows Node и рабочую область.

Намеренно нет привязки к беседе.

(user_id, project_id)
        |
        +-- node_id
        `-- workspace

Встроенная панель управления VPS

Запуск gwc-gateway обслуживает как веб-панель, так и удаленную конечную точку MCP.

Разделы панели управления:

• Dashboard — обзор проектов/узлов/активности

• Projects — проект → Windows-компьютер → привязки папок

• Windows Nodes — онлайн/офлайн узлы и одноразовые коды сопряжения

• Activity Logs — история аудита в разрезе пользователя с фильтрами

• Account & Security — информация об учетной записи/провайдере и безопасности

Средство выбора папок никогда не читает файловую систему VPS. Оно запрашивает информацию о каталогах у выбранного Windows Node через WebSocket VPS и отображает только каталоги внутри GWC_ALLOWED_ROOTS.

Аутентификация

Поддерживаемые методы входа:

• Регистрация и вход по email/паролю

• Google OAuth 2.0 / OpenID Connect

• JWT токены доступа для MCP/API клиентов

• HttpOnly cookie входа для встроенной веб-панели

Пароли хэшируются с помощью Argon2. Данные пользователей/проектов/узлов/аудита хранятся в SQLite базе данных VPS gateway.db. Если GWC_JWT_SECRET опущен, генерируется случайный секрет один раз и сохраняется в GWC_DATA_DIR.

Вход через Google

Создайте веб-приложение Google OAuth и настройте:

GWC_GOOGLE_CLIENT_ID=...
GWC_GOOGLE_CLIENT_SECRET=...
GWC_GOOGLE_REDIRECT_URI=https://gwc.example.com/auth/google/callback

Если GWC_GOOGLE_REDIRECT_URI опущен, но указаны ID/секрет клиента, шлюз выводит его из GWC_PUBLIC_BASE_URL. Вход через Google по умолчанию возвращает на встроенную панель управления.

Привязка проекта и выбор папки

Windows Node рекламирует только настроенные разрешенные корни:

$env:GWC_ALLOWED_ROOTS = "G:\;D:\Projects"

Панель управления VPS может просматривать:

Office-PC
├─ G:\
│  ├─ NiceC-WMS
│  ├─ OpenAkita
│  └─ PartyGame
└─ D:\Projects
   └─ another-project

Выбранная привязка проекта сохраняется на VPS:

user_id + "NiceC-WMS"
  -> Office-PC
  -> G:\NiceC-WMS

Узел проверяет выбранную папку перед тем, как шлюз сохранит ее. Пути за пределами разрешенных корней отклоняются.

Инструменты MCP

Проекты и узлы

• project_bind

• project_get

• project_list

• project_unbind

• node_pair

• node_list

• control_acquire

• control_status

• control_release

Файлы

files_tool(project_id, action, params) поддерживает:

• list

• read

• write

• patch

• search

• stat

• mkdir

• move

• copy

• delete

Прямые файловые операции изолированы в привязанной рабочей области проекта.

Shell и процессы

• shell_run — PowerShell/CMD, stdout/stderr/код выхода, таймаут

• process_tool — запуск/опрос/остановка/список с инкрементальными курсорами вывода

Git

git_tool поддерживает status, diff, log, branch, создание/переключение веток, add, commit, pull, push и show.

Браузер

browser_tool поддерживает обнаружение браузера, подключение CDP, запуск постоянного профиля, вкладки/страницы, навигацию, инспекцию DOM, клик/ввод/выбор, загрузку/скачивание в рамках рабочей области, скриншоты и закрытие.

Рабочий стол Windows

computer_tool поддерживает информацию о системе/процессах, запуск приложений, список/активацию окон, скриншоты, мышь/клавиатуру, буфер обмена и инспекцию/клик/ввод текста через Windows UI Automation.

Журналы активности

VPS записывает события аудита в разрезе пользователя в gateway.db. Панель управления отображает только записи аутентифицированного пользователя. Чувствительные поля, такие как пароли, токены доступа, заголовки авторизации, cookie, данные буфера обмена и полные значения содержимого, скрываются UI API.

Многоузловая блокировка и управление

Одна учетная запись может иметь несколько Windows-компьютеров:

Gateway
├─ Office-PC
├─ Warehouse-PC
└─ Home-PC

Интерактивные операции с браузером/рабочим столом используют аренду проекта на узел, чтобы два проекта не боролись за одну мышь/окно.

Уровни разрешений

Устанавливаются на каждом Windows Node:

GWC_PERMISSION_LEVEL=read | operate | admin

• read: только методы проверки/чтения

• operate: обычное кодирование и автоматизация

• admin: также разрешает прямое удаление файлов и Git push

GWC_ALLOWED_ROOTS является жесткой границей для прямых файловых операций коннектора и выбора рабочей области. Команды Shell по-прежнему выполняются с обычными разрешениями учетной записи Windows, поэтому используйте выделенного пользователя Windows с низкими привилегиями или виртуальную машину, когда требуется сильная изоляция на уровне ОС.

Установка шлюза на VPS

Python 3.11+:

git clone https://github.com/Neal86/gpt-windows-connector.git
cd gpt-windows-connector
python -m venv .venv
source .venv/bin/activate
pip install -e .

Настройка:

export GWC_HOST=0.0.0.0
export GWC_PORT=8787
export GWC_DATA_DIR=./data
export GWC_PUBLIC_BASE_URL=https://gwc.example.com
gwc-gateway

Публичные конечные точки:

Dashboard:   https://gwc.example.com/
Remote MCP:  https://gwc.example.com/mcp
Node WSS:    wss://gwc.example.com/ws/node
Health:      https://gwc.example.com/health

Включены Dockerfile и docker-compose.yml. В production используйте HTTPS/WSS перед сервисом.

Установка Windows Node

Установите пакет на Windows, создайте одноразовый код сопряжения из панели управления VPS, затем выполните:

$env:GWC_NODE_ID = "Office-PC"
$env:GWC_NODE_NAME = "Office PC"
$env:GWC_GATEWAY_WS = "wss://gwc.example.com/ws/node"
$env:GWC_PAIRING_CODE = "123456"
$env:GWC_ALLOWED_ROOTS = "G:\;D:\Projects"
$env:GWC_PERMISSION_LEVEL = "operate"
gwc-node

После успешного сопряжения шлюз выдает постоянный случайный токен узла. Узел сохраняет его в локальном каталоге данных приложения текущего пользователя и автоматически переподключается с heartbeat + экспоненциальной задержкой.

Безопасность

• Используйте HTTPS/WSS в production.

• Ограничьте GWC_ALLOWED_ROOTS.

• Предпочитайте read или operate; предоставляйте admin только при необходимости.

• Относитесь к JWT и постоянным токенам узлов как к секретам.

• Запускайте Windows Node под выделенной учетной записью Windows, где это возможно.

• MCP Python SDK зафиксирован на версии >=1.27.2,<2 и включена явная безопасность транспорта Host/Origin.

• Windows Node работает только на исходящие соединения; не открывайте локальные порты CDP, Shell или Node публично.

Предполагаемый цикл кодирования

AI -> VPS -> Windows Node
   read/search code
   -> patch/write
   -> build/test
   -> inspect errors
   -> patch again
   -> git diff/status
   -> commit/push when permitted
   -> VPS -> AI

Репозиторий остается независимым от CursorTouch/Windows-MCP. Windows-MCP не требуется во время выполнения.