Overview
MCPControl is a cross-platform control server for the Model Context Protocol (MCP), designed to provide programmatic control over system operations such as mouse, keyboard, window management, and screen capture functionality.
To use MCPControl, clone the repository from GitHub, install the necessary dependencies, build the project, and configure it with your MCP servers. After configuration, restart your MCP server to access the MCPControl service.
- Window management capabilities including listing, focusing, and resizing windows. - Mouse control with configurable speed, click operations, and cursor tracking. - Keyboard control for text input and key operations. - Screen operations including screen capture and active window detection. - Clipboard integration for managing clipboard content.
- Automating repetitive tasks on your computer.
- Enabling AI models to interact with applications and games.
- Managing multiple windows and applications programmatically.
Add to your AI client
Use these steps to connect MCPControl in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcpcontrol-cheffromspace": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcpcontrol-cheffromspace"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcpcontrol-cheffromspace": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcpcontrol-cheffromspace"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcpcontrol-cheffromspace": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcpcontrol-cheffromspace"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcpcontrol-cheffromspace": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcpcontrol-cheffromspace"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcpcontrol-cheffromspace": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcpcontrol-cheffromspace"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcpcontrol-cheffromspace": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcpcontrol-cheffromspace"
]
}
}
}FAQ
Is MCPControl safe to use?
This software is experimental and potentially dangerous. Use it at your own risk in controlled environments.
What platforms does MCPControl support?
MCPControl aims to support Windows, Linux, and macOS, though most testing has been on Windows.
How can I contribute to MCPControl?
Contributions are welcome! Please refer to the CONTRIBUTING.md file in the repository for guidelines.