MCPControl

Статус проекта : Снят с приоритета. Этот проект был создан как эксперимент, но автоматизация Windows — это не то, во что я хочу углубляться. Я рассмотрю и объединю PR, но не буду добавлять функции в ближайшее время. Возможно, вернусь в будущем. Ищу сопровождающего.

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

Примечание : в настоящее время этот проект поддерживает только Windows.

🔥 Почему MCPControl?

MCPControl устраняет разрыв между моделями ИИ и вашим рабочим столом, обеспечивая безопасное программное управление:

  • 🖱️ Движения и щелчки мыши
  • ⌨️ Ввод с клавиатуры и сочетания клавиш
  • 🪟 Управление окнами
  • 📸 Снимок экрана и анализ
  • 📋 Операции с буфером обмена

🔌 Быстрый старт

  1. Установите Node.js (если еще не установлен)
    # Visit https://nodejs.org and download the latest LTS version
  2. Настройте параметры MCP в клиенте Claude:
    { "mcpServers": { "MCPControl": { "command": "npx", "args": [ "--no-cache", "-y", "mcp-control" ] } } }
  3. Перезапустите клиент , и MCPControl появится в меню MCP!

🚀 Популярные варианты использования

Вспомогательная автоматизация

  • Тестирование приложений : делегируйте повторное тестирование пользовательского интерфейса Клоду, что позволит ИИ перемещаться по приложениям и сообщать о проблемах.
  • Автоматизация рабочего процесса : пусть Клод управляет приложениями от вашего имени, выполняя повторяющиеся задачи, пока вы сосредоточены на творческой работе.
  • Заполнение форм : позвольте Клоду заняться задачами по вводу данных под вашим руководством.

Эксперименты с ИИ

  • Игры с искусственным интеллектом : наблюдайте, как Клод учится играть в простые игры с помощью визуальной обратной связи
  • Визуальное мышление : проверьте способность Клода ориентироваться в визуальных интерфейсах и решать визуальные головоломки.
  • Сотрудничество человека и искусственного интеллекта : исследуйте новые парадигмы взаимодействия, где Клод может видеть ваш экран и помогать со сложными задачами.

Разработка и тестирование

  • Интеграция между приложениями : объединение приложений, которые обычно не взаимодействуют друг с другом
  • Среда тестирования пользовательского интерфейса : создание надежных сценариев тестирования с визуальной проверкой
  • Создание демонстраций : автоматизация создания демонстраций продуктов.

⚠️ ВАЖНЫЙ ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ

ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ЯВЛЯЕТСЯ ЭКСПЕРИМЕНТАЛЬНЫМ И ПОТЕНЦИАЛЬНО ОПАСНЫМ

Используя это программное обеспечение, вы признаете и принимаете, что:

  • Предоставление моделям ИИ прямого контроля над вашим компьютером с помощью этого инструмента по своей сути рискованно
  • Это программное обеспечение может управлять вашей мышью, клавиатурой и другими системными функциями, что может привести к непредвиденным последствиям.
  • Вы используете это программное обеспечение исключительно на свой страх и риск.
  • Создатели и участники этого проекта НЕ несут ответственности за любой ущерб, потерю данных или другие последствия, которые могут возникнуть в результате использования этого программного обеспечения.
  • Этот инструмент следует использовать только в контролируемых условиях с соблюдением соответствующих мер безопасности.

ИСПОЛЬЗУЙТЕ НА СВОЙ СТРАХ И РИСК

🌟 Особенности

🛠️ Настройка разработки

Если вы заинтересованы в участии или сборке из исходников, подробные инструкции см. на сайте CONTRIBUTING.md .

Требования к разработке

Для создания этого проекта для разработки вам понадобится:

  1. Операционная система Windows (требуется для зависимости keysender)
  2. Node.js 18 или более поздней версии (установите с помощью официального установщика Windows, который включает в себя инструменты сборки)
  3. менеджер пакетов npm
  4. Собственные инструменты сборки:
    • node-gyp: npm install -g node-gyp
    • cmake-js: npm install -g cmake-js

Зависимость keysender опирается на собственные модули Windows, которым требуются эти инструменты сборки.

📋 Структура проекта

  • /src
    • /handlers - Обработчики запросов и управление инструментами
    • /tools - Реализации основных функций
    • /types — определения типов TypeScript
    • index.ts — Основная точка входа в приложение

🔖 Ветки репозитория

  • main - Основная ветка разработки с последними функциями и изменениями
  • release — стабильная ветка релиза, которая отражает последний стабильный тег (в настоящее время v0.1.22)

Установка версии

Вы можете установить определенные версии MCPControl с помощью npm:

# Install the latest stable release (from release branch) npm install mcp-control # Install a specific version npm install mcp-control@0.1.22

📚 Зависимости

  • @modelcontextprotocol/sdk — MCP SDK для реализации протокола
  • keysender — библиотека автоматизации пользовательского интерфейса только для Windows
  • clipboardy - Обработка буфера обмена
  • резкость - Обработка изображений
  • uuid - генерация UUID

🚧 Известные ограничения

  • Операции минимизации/восстановления окон в настоящее время не поддерживаются.
  • Функции нескольких экранов могут работать не так, как ожидалось, в зависимости от настроек.
  • Утилита get_screenshot не работает с расширением VS Code Cline. См. GitHub issue #1865
  • Для некоторых операций могут потребоваться повышенные разрешения в зависимости от целевого приложения.
  • Поддерживается только Windows.
  • MCPControl лучше всего работает при разрешении 1280x720, один экран. Точность щелчка оптимизирована для этого разрешения. Мы работаем над ошибкой смещения/масштабирования и ищем тестировщиков или помощь в создании инструментов тестирования

👥 Вклад

См. CONTRIBUTING.md

Примечание : Поскольку этот проект в настоящее время находится в режиме только обслуживания, мы в первую очередь сосредоточены на исправлении ошибок. Однако полностью реализованные и хорошо протестированные функции будут рассмотрены для слияния. Ищем сопровождающих, которые помогут поддерживать проект активным.

⚖️ Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

📖 Ссылки

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

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

  1. 🔥 Почему MCPControl?
    1. 🔌 Быстрый старт
      1. 🚀 Популярные варианты использования
        1. Вспомогательная автоматизация
        2. Эксперименты с ИИ
        3. Разработка и тестирование
      2. ⚠️ ВАЖНЫЙ ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ
        1. 🌟 Особенности
          1. 🛠️ Настройка разработки
            1. Требования к разработке
          2. 📋 Структура проекта
            1. 🔖 Ветки репозитория
              1. Установка версии
            2. 📚 Зависимости
              1. 🚧 Известные ограничения
                1. 👥 Вклад
                  1. ⚖️ Лицензия
                    1. 📖 Ссылки

                      Related MCP Servers

                      • A
                        security
                        A
                        license
                        A
                        quality
                        A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
                        Last updated -
                        3
                        9
                        36
                        JavaScript
                        Apache 2.0
                      • A
                        security
                        A
                        license
                        A
                        quality
                        A Model Context Protocol server that provides secure command-line access to Windows systems, allowing MCP clients like Claude Desktop to safely execute commands in PowerShell, CMD, and Git Bash shells with configurable security controls.
                        Last updated -
                        9
                        350
                        105
                        JavaScript
                        MIT License
                      • -
                        security
                        -
                        license
                        -
                        quality
                        A Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
                        Last updated -
                        2
                      • -
                        security
                        A
                        license
                        -
                        quality
                        Provides automated GUI testing and control capabilities through an MCP server that enables mouse movements, keyboard input, screen captures, and image recognition across Windows, macOS, and Linux.
                        Last updated -
                        6
                        Python
                        MIT License
                        • Apple
                        • Linux

                      View all related MCP servers

                      ID: r3fdu3l0yz