winuse-mcp

Управление компьютером для Claude Code в Windows. MCP-сервер, позволяющий Claude видеть ваш экран и управлять мышью и клавиатурой.

Claude Code предоставляет управление компьютером в CLI только на macOS, поэтому в Windows сервер computer-use никогда не появляется в /mcp. Этот проект воссоздает тот же цикл создания скриншотов и кликов на Windows API: 14 инструментов, 5 зависимостей, Python 3.12.

Установка

Требуется Windows и uv. Добавьте это в .mcp.json в проекте или в ~/.claude.json для всех проектов:

{
  "mcpServers": {
    "winuse": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ryanportfolio/winuse-mcp", "winuse-mcp"]
    }
  }
}

Из локального клона вместо этого:

{
  "mcpServers": {
    "winuse": {
      "command": "uv",
      "args": ["run", "--directory", "C:/path/to/winuse-mcp", "winuse-mcp"]
    }
  }
}

Перезапустите Claude Code, затем попросите его посмотреть на ваш экран или кликнуть в приложении.

Related MCP server: Win:Computer Use

Возможности

Координаты всегда в пространстве скриншота. См. ниже.

Как работают координаты

Скриншоты уменьшаются так, чтобы длинная сторона была не более 1372 пикселей — тот же целевой размер, который Claude Code использует на macOS. Claude никогда не видит нативные пиксели, поэтому он кликает в уменьшенном изображении, а сервер преобразует обратно.

Дисплей 1920x1080 захватывается как 1372x772, коэффициент 0.715. Клик в 686, 443 попадает в 960, 620.

Сервер объявляет себя DPI-осведомленным при запуске, поэтому масштабирование дисплея Windows на 125% или 150% не искажает попадание кликов.

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

Это передает управление вашим рабочим столом языковой модели. Собственная версия Anthropic оборачивает тот же цикл в защитные механизмы, которых у этого сервера нет: одобрение для каждого приложения, скрытие приложений, которые Claude не был одобрен для использования, исключение вашего терминала из скриншотов и проверки на стороне модели для каждого действия.

Что вы получаете:

• Claude Code запрашивает разрешение перед каждым вызовом инструмента, если вы не добавили его в белый список. Оставьте инструменты ввода на ручном одобрении и добавьте в белый список только screenshot.

• Поместите мышь в верхний левый угол экрана, чтобы прервать выполняемое действие. Это защитный механизм pyautogui, и он отслеживает только этот угол. Прерывание во время перетаскивания отпускает кнопку мыши при выходе, поэтому ничего не остается в режиме перетаскивания.

• Все видимое достигает модели, включая то, что находится на экране. Текст на экране является непроверенным вводом: относитесь к инструкциям, появляющимся там, как к риску внедрения промптов.

Ограничения

• Только основной монитор.

• Ваш терминал не исключается из скриншотов, поэтому Claude видит свою собственную сессию.

• record сэмплирует статические кадры, не более 8. Видео нет.

Разработка

uv sync
uv run winuse-mcp

scripts/client_test.py — эталонная проверка: он общается с сервером через MCP по stdio, выводит список инструментов, делает скриншот, перемещает мышь и считывает позицию, записывает кадры и проверяет, что неверная комбинация клавиш вызывает ошибку.

uv run python scripts/client_test.py

scripts/failsafe_test.py охватывает пути, с которыми сталкивается пользователь при прерывании, с заглушкой pyautogui, чтобы не требовалось реального прерывания: прерванное перетаскивание все равно отпускает кнопку, прерванная горизонтальная прокрутка все равно отпускает shift, разбор аккордов обрабатывает буквальный +, и ни один клик не может попасть в пиксель защитного механизма.

uv run python scripts/failsafe_test.py

Этот README собирается. Каждое число на странице пересчитывается из исходного кода во время сборки, и сборка завершается ошибкой, если одно отклоняется.

node scripts/readme/build.mjs

Лицензия

MIT