Windows-MCP

Windows-MCP — лёгкий open-source проект, обеспечивающий бесшовную интеграцию AI-агентов с операционной системой Windows. Выступая в роли MCP-сервера, он устраняет разрыв между LLM и Windows, позволяя агентам выполнять такие задачи, как навигация по файлам, управление приложениями, взаимодействие с UI, QA-тестирование и многое другое.

mcp-name: io.github.CursorTouch/Windows-MCP

Обновления

• Добавлена поддержка VM для Windows-MCP. Подробнее на windowsmcp.io.
• Windows-MCP достиг отметки 2M+ пользователей в Claude Desktop Extensions.
• Попробуйте 🪟Windows-Use — агент, построенный на основе Windows-MCP.
• Windows-MCP теперь доступен на PyPI (поддерживается uvx windows-mcp).
• Windows-MCP добавлен в MCP Registry.

Поддерживаемые операционные системы

• Windows 7
• Windows 8, 8.1
• Windows 10
• Windows 11

🎥 Демонстрации

https://github.com/user-attachments/assets/d0e7ed1d-6189-4de6-838a-5ef8e1cad54e

https://github.com/user-attachments/assets/d2b372dc-8d00-4d71-9677-4c64f5987485

✨ Ключевые возможности

• Бесшовная интеграция с Windows Нативное взаимодействие с элементами UI Windows: открытие приложений, управление окнами, симуляция пользовательского ввода и многое другое.

• Поддержка любых LLM (компьютерное зрение не требуется) В отличие от многих инструментов автоматизации, Windows-MCP не использует традиционные техники компьютерного зрения и не требует специально дообученных моделей — работает с любыми LLM, снижая сложность настройки.

• Богатый набор инструментов для UI-автоматизации Включает инструменты для базовых операций с клавиатурой и мышью, а также захвата состояния окон и UI.

• Лёгкий и открытый исходный код Минимальные зависимости, простая установка, полный исходный код под лицензией MIT.

• Гибкость и расширяемость Легко адаптируйте или расширяйте инструменты под свои задачи автоматизации или интеграции с AI.

• Взаимодействие в реальном времени Типичная задержка между действиями (например, от одного клика мышью до следующего) составляет от 0.2 до 0.9 сек и может незначительно варьироваться в зависимости от числа активных приложений, нагрузки на систему и скорости инференса LLM.

• DOM-режим для автоматизации браузера Специальный режим use_dom=True для State-Tool, фокусирующийся исключительно на содержимом веб-страницы и фильтрующий элементы UI браузера для более чистой и эффективной веб-автоматизации.

🛠️ Установка

Примечание: При первой установке этого MCP-сервера может потребоваться одна-две минуты на установку зависимостей из pyproject.toml. При первом запуске сервер может завершиться по таймауту — проигнорируйте это и перезапустите его.

Предварительные требования

• Python 3.13+
• UV (менеджер пакетов) от Astral, установка: pip install uv или curl -LsSf https://astral.sh/uv/install.sh | sh
• В качестве языка по умолчанию в Windows рекомендуется English; в противном случае отключите App-Tool в MCP-сервере при использовании других языков.

1. Установите Claude Desktop и выполните:

2. Настройте расширение:

Вариант A: Установка из PyPI (рекомендуется)

Используйте uvx для запуска последней версии напрямую из PyPI.

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}

Вариант B: Установка из исходного кода

1. Клонируйте репозиторий:

git clone https://github.com/CursorTouch/Windows-MCP.git
cd Windows-MCP

2. Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<путь к директории windows-mcp>",
        "run",
        "windows-mcp"
      ]
    }
  }
}

3. Откройте Claude Desktop и наслаждайтесь! 🥳

Claude Desktop MSIX (Windows Store)

MSIX-пакет Claude Desktop виртуализирует %APPDATA%. Конфигурация находится по адресу: %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json (не %APPDATA%\Claude\). Кнопка «Edit Config» может открыть неверный файл.

Electron-приложения также не наследуют PATH, поэтому uv/uvx могут завершаться с ошибкой spawn ENOENT. Используйте полный абсолютный путь к uv.exe:

{
  "mcpServers": {
    "windows-mcp": {
      "command": "C:\\Users\\<user>\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\<user>\\AppData\\Local\\Packages\\Claude_pzs8sxrjxfjjc\\LocalCache\\Roaming\\Claude\\Claude Extensions\\ant.dir.cursortouch.windows-mcp",
        "run",
        "windows-mcp"
      ]
    }
  }
}

Замените <user> на ваше имя пользователя. Чтобы найти uv.exe, выполните where uv в терминале; обычное расположение — %USERPROFILE%\.local\bin\uv.exe.