Mcpcontrol

🚀 MCPControl Server

MCPControl is a control server based on the Windows model context protocol, offering programmatic control over system operations, including mouse, keyboard, window management, and screen capture capabilities.

🚀 Quick Start

🎥 Quick Demo (30-Second Stunning Demo)

Want to see what MCPControl can do? Try our interactive demo:

# Run the demo with a single command
node demo.cjs

The demo will:

1. Showcase available MCPControl tools
2. Display your screen size
3. Track the mouse position
4. Retrieve active window information
5. Optionally capture screenshots and save them to your desktop

No need to run additional commands; the demo manages the MCPControl server automatically.

⚠️ Important Note

This project currently only supports the Windows operating system.

⚠️ Important Disclaimer

This software is experimental and potentially dangerous.

By using this software, you acknowledge and accept the following:

• There are inherent risks in allowing an AI model to directly control your computer through this tool.
• This software can control the mouse, keyboard, and other system functions, which may lead to unexpected consequences.
• You use this software entirely at your own risk.
• The creators and contributors of this project are not responsible for any damage, data loss, or other consequences resulting from the use of this software.
• This tool should be used in a controlled environment with appropriate security measures.

Use at your own risk.

✨ Features

• Window Management

  • List all windows
  • Get active window information
  • Get window titles
  • Get window size and position
  • Focus on windows
  • Resize windows
  • Move windows

• Mouse Control

  • Move the mouse
  • Perform click operations
  • Scroll functionality
  • Drag and drop operations
  • Track mouse position

• Keyboard Control

  • Text input
  • Key combinations
  • Key press/release operations
  • Lock key functionality

• Screen Operations

  • Screen capture
  • Get screen size
  • Detect active windows

• Clipboard Integration

  • Get clipboard content
  • Set clipboard content
  • Clear the clipboard
  • Get clipboard status

And many more!

🔧 Known Limitations

• Window minimize/restore operations are currently not supported.
• Multi-screen functionality may not work correctly depending on settings.
• The get_screenshot utility is incompatible with the VS Code extension Cline. See GitHub Issue #1865.
• Some operations may require elevated privileges, depending on the target application.
• Only the Windows operating system is supported.
• Ctrl key combinations (e.g., Ctrl+C, Ctrl+V) may cause the server to crash due to stdio handling issues. This will be addressed in an upcoming release with a new streaming HTTP transport protocol in the MCP specification. See GitHub Issue #120.

🤝 Contributing

Check out CONTRIBUTING.md

📄 License

This project is open-source under the MIT License. See the LICENSE file for details.

📚 References

• Model Context Protocol Documentation