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

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

🔥 Почему MCPControl?

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

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

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

Требования

1. Установите инструменты сборки (включая нагрузку VC++)

2. Установить Python (если он ещё не установлен)

3. Установить Node.js

Установка

1. Установка пакета MCPControl

Конфигурация

MCPControl лучше всего работает в виртуальной машине с разрешением 1280x720 для оптимальной точности клицания.

Настройте клиент Claude для подключения к MCPControl через SSE-транспорт:

Вариант 1: Прямое подключение SSE

Для подключения к серверу MCPControl, работающему на виртуальной машине или удалённой машине:

Замените 192.168.1.100:3232 на IP-адрес и порт вашего сервера.

Вариант 2: Локальный запуск с SSE

MCPControl

Windows control server for the Model Context Protocol, providing programmatic control over system operations including mouse, keyboard, window management, and screen capture functionality.

Note: This project currently supports Windows only.

🔥 Why MCPControl?

MCPControl bridges the gap between AI models and your desktop, enabling secure, programmatic control of:

• 🖱️ Mouse movements and clicks
• ⌨️ Keyboard input and shortcuts
• 🪟 Window management
• 📸 Screen capture and analysis
• 📋 Clipboard operations

🔌 Quick Start

Prerequisites

1. Install Build Tools (including VC++ workload)

   # Run as Administrator - may take a few minutes to complete
   winget install Microsoft.VisualStudio.2022.BuildTools --override "--wait --passive --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"
   

2. Install Python (if not already installed)

   # Install Python (required for node-gyp)
   winget install Python.Python.3.12
   

3. Install Node.js

   # Install latest LTS version
   winget install OpenJS.NodeJS
   

Installation

1. Install MCPControl Package

   npm install -g mcp-control
   

Configuration

MCPControl works best in a virtual machine at 1280x720 resolution for optimal click accuracy.

Configure your Claude client to connect to MCPControl via SSE transport:

Option 1: Direct SSE Connection

For connecting to an MCPControl server running on a VM or remote machine:

{
  "mcpServers": {
    "MCPControl": {
      "transport": "sse",
      "url": "http://192.168.1.100:3232/mcp"
    }
  }
}

Replace 192.168.1.100:3232 with your server’s IP address and port.

Option 2: Local Launch with SSE

To launch MCPControl locally with SSE transport:

{
  "mcpServers": {
    "MCPControl": {
      "command": "mcp-control",
      "args": ["--sse"]
    }
  }
}

Starting the Server

First, start the MCPControl server on your VM or local machine:

mcp-control --sse

The server will display:

• Available network interfaces and their IP addresses
• The port number (default: 3232)
• Connection status messages

VM Setup Example

1. Start your Windows VM with 1280x720 resolution
2. Install MCPControl on the VM:

   npm install -g mcp-control
   

3. Run the server with SSE transport:

   mcp-control --sse
   

4. Note the VM’s IP address (e.g., 192.168.1.100)
5. Configure Claude with the SSE URL:

   {