모델 컨텍스트 프로토콜을 위한 윈도우 제어 서버로, 마우스, 키보드, 창 관리, 화면 캡처 기능을 포함한 시스템 운영에 대한 프로그래밍 제어를 제공합니다.

참고: 이 프로젝트는 현재 Windows만 지원합니다.

🔥 왜 MCPControl인가요?

MCPControl은 AI 모델과 데스크톱 간의 간극을 메워 다음 분야의 안전하고 프로그래밍된 제어를 가능하게 합니다:

• 🖱️ 마우스 움직임과 클릭
• ⌨️ 키보드 입력 및 단축키
• 🪟 창 관리
• 📸 화면 캡처 및 분석
• 📋 클립보드 작업

🔌 퀵 스타트

전제 조건

1. 빌드 도구 설치(VC++ 작업 포함)

2. Python을 설치하세요 (아직 설치하지 않았다면)

3. 설치 Node.js

설치

1. MCPControl 패키지 설치

구성

MCPControl은 최적의 클릭 정확도를 위해 1280x720 해상도의 가상 머신에서 가장 잘 작동합니다.

Claude 클라이언트가 SSE 전송을 통해 MCPControl에 연결되도록 설정하세요:

옵션 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:

   {