Mcpcontrol

🚀 MCPControl

MCPControl enables advanced control of Windows systems through the Model Context Protocol.

🚀 Quick Start

MCPControl is a control server based on the Model Context Protocol (MCP), specifically designed for Windows systems. It offers a range of powerful features, including:

• Mouse and Keyboard Control: Achieve precise mouse clicks and movements, as well as simulate keyboard input.
• Window Management: Support operations such as window creation, activation, minimization, restoration, and closure.
• Screen Capture: Capture screen content and return it to the client for further processing.
• Clipboard Operations: Read or write clipboard data for convenient data transfer.

MCPControl provides developers and researchers with a powerful toolset for implementing automation tasks, test scripts, and integrating with AI models.

📦 Installation

Quick Start

1. Install Node.js: Ensure that Node.js 18 or a higher version is installed on your system.
2. Install MCPControl:

   npm install mcp-control
   

3. Configure MCP Settings: Import the MCP SDK into your project and initialize the control service.

💻 Usage Examples

Basic Usage

const { MCP } = require('@modelcontextprotocol/sdk');
const control = new MCP.Control();

// Mouse click example
control.mouse.click().catch(console.error);

// Keyboard input example
control.keyboard.type('Hello, World!').catch(console.error);

// Screen capture example
async function captureScreen() {
  try {
    const screenshot = await control.screen.capture();
    console.log('Screenshot captured:', screenshot);
  } catch (error) {
    console.error('Failed to capture screenshot:', error);
  }
}
captureScreen();

// Clipboard operation example
control.clipboard.write('Copied text').catch(console.error);

✨ Features

Mouse Control

• Click: Support left - click, right - click, and scroll wheel events.
• Move: Precisely control the mouse pointer position for smooth movement.
• Scroll: Simulate mouse wheel operations for window zooming or scroll bar adjustment.

Keyboard Control

• Input Text: Directly send character streams to the target window.
• Keys and Key Combinations: Support single - key presses and releases, as well as key combinations (e.g., Ctrl + C).
• Virtual Keyboard: Input complex characters using Unicode code points.

Window Management

• Create Window: Generate a new top - level window with specified parameters.
• Activate Window: Transfer the active focus to the target window.
• Minimize/Restore: Control the window state for convenient interface layout adjustment.
• Close Window: Force - close the target window or dialog box.

Screen Capture

• Full - Screen Capture: Capture image data of the entire display area.
• Specified Area Capture: Capture a specific rectangular area of the screen.
• High - Quality Output: Support multiple image formats, such as PNG and JPEG.

Clipboard Operations

• Read Content: Retrieve text or image data from the current clipboard.
• Write Content: Paste new content into the clipboard for subsequent processing.

🔧 Technical Details

Core Dependencies

MCPControl relies on the following key libraries:

• keysender: A powerful UI automation library for the Windows platform, supporting window and control operations.
• @modelcontextprotocol/sdk: The official SDK for the MCP protocol, enabling interaction with models.
• sharp: Used for efficient image processing and conversion.
• clipboardy: Implements read and write functions for clipboard data.

System Requirements

• Operating System: Windows 7 or a higher version (Windows 10/11 recommended).
• Node.js Version: 18.0.0 or a higher version.
• Permissions: Some advanced operations may require administrator privileges.

🤝 Development and Contribution

Contribution Guidelines

We welcome active participation and contributions from the community! Please refer to CONTRIBUTING.md to learn how to contribute to the project.

Issue Reporting

If you encounter any problems or find bugs during use, please submit issues on the GitHub repository.

📄 License

MCPControl is licensed under the MIT License, allowing free use, modification, and distribution while retaining the copyright notice.

📞 Contact Us

• Official Documentation: Model Context Protocol Documentation
• GitHub Repository: mcp-control
• Community Discussion Group: Welcome to join our Discord community for communication.

Combining intelligence with control, explore the endless possibilities of MCPControl!