Computer Control

v1.0.0Browser Automationstable

MCP server that provides computer control capabilities, like mouse, keyboard, OCR, etc. using PyAutoGUI, RapidOCR, ONNXRuntime. Similar to 'computer-use' by Anthropic. With Zero External Dependencies.

automationcomputer-usemcp
Share:
142
Stars
0
Downloads
0
Weekly
0/5

What is Computer Control?

Computer Control is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that provides computer control capabilities, like mouse, keyboard, ocr, etc. using pyautogui, rapidocr, onnxruntime. similar to 'computer-use' by anthropic. with zero external dependencies.

MCP server that provides computer control capabilities, like mouse, keyboard, OCR, etc. using PyAutoGUI, RapidOCR, ONNXRuntime. Similar to 'computer-use' by Anthropic. With Zero External Dependencies.

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server that provides computer control capabilities, like

Use Cases

Control mouse and keyboard
Perform OCR on screen content
Automate desktop interactions
AB498

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx computer-control-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Computer Control

Computer Control MCP is a Python-based MCP server that gives AI assistants direct control over a desktop computer's mouse, keyboard, and screen using PyAutoGUI for input simulation and RapidOCR with ONNXRuntime for optical character recognition — all bundled with zero external binary dependencies. It exposes tools for clicking, typing, dragging, pressing key combinations, taking screenshots, extracting text from the screen, listing windows, and activating specific application windows. AI assistants can use it to automate desktop workflows, interact with applications that have no API, and read on-screen content, making it functionally similar to Anthropic's computer-use capability.

Prerequisites

  • Python 3.8 or higher installed
  • uvx (from the uv package manager) or pip for installation
  • Desktop environment access (Windows, macOS, or Linux with display server)
  • An MCP-compatible client such as Claude Desktop
  • On Linux: a display server (X11 or Wayland) and appropriate display permissions
1

Pre-download dependencies on first run

The first run downloads around 70MB of Python dependencies including ONNXRuntime models. Run this in a terminal first so the MCP client does not time out waiting.

uvx computer-control-mcp@latest
2

Configure your MCP client

Add the server to your MCP client configuration. The recommended approach uses uvx so no manual installation is needed.

3

Optional: install globally with pip

If you prefer a persistent installation rather than using uvx each time, install the package globally.

pip install computer-control-mcp
4

Optional: customize screenshot directory

By default screenshots are saved to the OS downloads folder. Set the COMPUTER_CONTROL_MCP_SCREENSHOT_DIR environment variable to change this.

# macOS/Linux
export COMPUTER_CONTROL_MCP_SCREENSHOT_DIR="/home/yourname/Pictures/Screenshots"
# Windows PowerShell
$env:COMPUTER_CONTROL_MCP_SCREENSHOT_DIR = "C:\Users\YourName\Pictures\Screenshots"
5

Optional: enable Windows Graphics Capture for GPU-accelerated windows

On Windows, traditional screenshots return black screens for GPU-accelerated apps like browsers, games, and Electron apps. Configure WGC patterns to automatically use the Windows Graphics Capture API for matched windows.

# In MCP client env config:
# COMPUTER_CONTROL_MCP_WGC_PATTERNS=obs, discord, chrome, game

Computer Control Examples

Client configuration

Claude Desktop configuration using uvx to run the latest version of computer-control-mcp with a custom screenshot directory.

{
  "mcpServers": {
    "computer-control-mcp": {
      "command": "uvx",
      "args": ["computer-control-mcp@latest"],
      "env": {
        "COMPUTER_CONTROL_MCP_SCREENSHOT_DIR": "/Users/yourname/Downloads/screenshots"
      }
    }
  }
}

Prompts to try

Example prompts using the mouse, keyboard, screenshot, and OCR tools exposed by the server.

- "Take a screenshot of my entire screen and describe what you see"
- "Click at coordinates (500, 300) on the screen"
- "Type 'Hello World' at the current cursor position"
- "Use OCR to read all text visible on the screen and list every window title you find"
- "Press Ctrl+C to copy the selected text, then tell me what was on the clipboard"

Troubleshooting Computer Control

First run takes a very long time or times out in the MCP client

Run 'uvx computer-control-mcp@latest' once in a terminal before configuring the MCP client. This pre-downloads the ~70MB of dependencies. Subsequent launches are instant.

Screenshots of browser or Electron app windows are completely black

These are GPU-accelerated windows that standard GDI capture cannot handle. On Windows, set COMPUTER_CONTROL_MCP_WGC_PATTERNS to match the window title (e.g., 'chrome, discord'). The take_screenshot tool also accepts a 'use_wgc=true' flag per call.

Mouse clicks or keyboard events have no effect on Linux

PyAutoGUI requires a running X11 display. Set the DISPLAY environment variable (e.g., 'DISPLAY=:0') in the MCP client's env config. On Wayland, additional setup or an XWayland compatibility layer may be required.

Frequently Asked Questions about Computer Control

What is Computer Control?

Computer Control is a Model Context Protocol (MCP) server that mcp server that provides computer control capabilities, like mouse, keyboard, ocr, etc. using pyautogui, rapidocr, onnxruntime. similar to 'computer-use' by anthropic. with zero external dependencies. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Computer Control?

Follow the installation instructions on the Computer Control GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Computer Control?

Computer Control works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Computer Control free to use?

Yes, Computer Control is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Browser Automation MCP Servers

Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "computer-control-mcp": { "command": "npx", "args": ["-y", "computer-control-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Computer Control?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides