モデルコンテキストプロトコル用のWindows制御サーバーで、マウス、キーボード、ウィンドウ管理、スクリーンキャプチャ機能などのシステム操作をプログラム的に制御します。

注:このプロジェクトは現在Windowsのみをサポートしています。

🔥 なぜMCPControlなのか?

MCPControlはAIモデルとデスクトップの間の橋渡しを行い、以下の安全でプログラム的な制御を可能にします:

• 🖱️ マウスの動きとクリック音
• ⌨️ キーボード入力とショートカット
• 🪟 ウィンドウ管理
• 📸 スクリーンキャプチャと解析
• 📋 クリップボード操作

🔌 クイックスタート

前提条件

1. ビルドツール(VC++ワークロードを含む)をインストールする

2. Pythonをインストールしてください(まだインストールしていなければ)

3. インストールNode.js

就任

1. MCPControlパッケージをインストールする

構成

MCPControlは、最適なクリック精度を得るために、1280x720解像度の**仮想マシンで最適に動作します。

ClaudeクライアントをSSEトランスポート経由でMCPControlに接続するように設定してください:

オプション1:直接SSE接続

VMまたはリモートマシン上で動作する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:

   {