用于模型上下文协议的Windows控制服务器，提供对系统操作的程序化控制，包括鼠标、键盘、窗口管理和屏幕捕捉功能。

注：本项目目前仅支持 Windows。

🔥 为什么是MCPControl？

MCPControl 弥合了 AI 模型与您的桌面之间的鸿沟，实现了安全、程序化的控制：

• 🖱️ 鼠标移动和点击
• ⌨️ 键盘输入与快捷键
• 🪟 窗口管理
• 📸 截屏与分析
• 📋 剪贴板操作

🔌 快速启动

先决条件

1. 安装构建工具（包括VC++工作负载）

2. 安装Python（如果还没安装）

3. 安装Node.js

安装

1. 安装MCPControl包

配置

MCPControl 在 虚拟机 1280x720 分辨率下工作最佳，以获得最佳点击精度。

配置您的Claude客户端通过SSE传输连接到MCPControl：

选项1：直接SSE连接

连接运行在虚拟机或远程机器上的MCPControl服务器：

用你服务器的IP地址和端口替换192.168.1.100:3232。

选项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:

   {