l feedback - **Visual Reasoning**: Test Claude's ability to navigate visual interfaces and solve visual puzzles - **Human-AI Collaboration**: Explore new interaction paradigms where Claude can see your screen and help with complex tasks ### Development and Testing - **Cross-Application Integration**: Bridge applications that don't normally communicate - **UI Testing Framework**: Create robust testing scenarios with visual validation - **Demo Creation**: Automate the creation of product demonstrations ## ⚠️ IMPORTANT DISCLAIMER **THIS SOFTWARE IS EXPERIMENTAL AND POTENTIALLY DANGEROUS** By using this software, you acknowledge and accept that: - Giving AI models direct control over your computer through this tool is inherently risky - This software can control your mouse, keyboard, and other system functions which could potentially cause unintended consequences - You are using this software entirely at your own risk - The creators and contributors of this project accept NO responsibility for any damage, data loss, or other consequences that may arise from using this software - This tool should only be used in controlled environments with appropriate safety measures in place **USE AT YOUR OWN RISK** ## 🌟 Features

🪟 Window Management

List all windows
Get active window info
Focus, resize & reposition

🖱️ Mouse Control

Precision movement
Click & drag operations
Scrolling & position tracking

⌨️ Keyboard Control

Text input & key combos
Key press/release control
Hold key functionality

📸 Screen Operations

High-quality screenshots
Screen size detection
Active window capture

## 🛠️ Development Setup If you're interested in contributing or building from source, please see [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions. ### Development Requirements To build this project for development, you'll need: 1. Windows operating system (required for the keysender dependency) 2. Node.js 18 or later (install using the official Windows installer which includes build tools) 3. npm package manager 4. Native build tools: - node-gyp: `npm install -g node-gyp` - cmake-js: `npm install -g cmake-js` The keysender dependency relies on Windows-specific native modules that require these build tools. ## 📋 Project Structure - `/src` - `/handlers` - Request handlers and tool management - `/tools` - Core functionality implementations - `/types` - TypeScript type definitions - `index.ts` - Main application entry point ## 🔖 Repository Branches - **`main`** - Main development branch with the latest features and changes - **`release`** - Stable release branch that mirrors the latest stable tag (currently v0.1.22) ### Version Installation You can install specific versions of MCPControl using npm: ```bash # Install the latest stable release (from release branch) npm install mcp-control # Install a specific version npm install mcp-control@0.1.22 ``` ## 📚 Dependencies - [@modelcontextprotocol/sdk](https://www.npmjs.com/package/@modelcontextprotocol/sdk) - MCP SDK for protocol implementation - [keysender](https://www.npmjs.com/package/keysender) - Windows-only UI automation library - [clipboardy](https://www.npmjs.com/package/clipboardy) - Clipboard handling - [sharp](https://www.npmjs.com/package/sharp) - Image processing - [uuid](https://www.npmjs.com/package/uuid) - UUID generation ## 🚧 Known Limitations - Window minimize/restore operations are currently unsupported - Multiple screen functions may not work as expected, depending on setup - The get_screenshot utility does not work with the VS Code Extension

#computer-control

MCPControl