💻 mcp-vnc

Un servidor de Model Context Protocol (MCP) que permite a los agentes de IA controlar de forma remota Windows, Linux, macOS o cualquier otra cosa que pueda ejecutar un servidor VNC (no te preocupes, probablemente esté bien).

🚀 Inicio Rápido

Instalar desde NPM

npm install -g @hrrrsn/mcp-vnc

Instalar desde el código fuente

git clone https://github.com/hrrrsn/mcp-vnc
cd mcp-vnc
npm install
npm run build

Related MCP server: mcp-vnc

⚙️ Configuración

Claude Desktop

1. Localiza y abre tu archivo de configuración de Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Añade la siguiente configuración:

Usando la instalación desde NPM:

{
  "mcpServers": {
    "vnc-controller": {
      "type": "stdio",
      "command": "mcp-vnc",
      "env": {
        "VNC_HOST": "192.168.1.100",
        "VNC_PORT": "5900",
        "VNC_PASSWORD": "your-vnc-password",
        "VNC_TIMEOUT": "30000"
      }
    }
  }
}

Compilado desde el código fuente:

{
  "mcpServers": {
    "vnc-controller": {
      "type": "stdio",
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/mcp-vnc",
      "env": {
        "VNC_HOST": "192.168.1.100",
        "VNC_PORT": "5900",
        "VNC_PASSWORD": "your-vnc-password",
        "VNC_TIMEOUT": "30000"
      }
    }
  }
}

VNC_TIMEOUT (opcional) establece cuánto tiempo espera cada llamada a una herramienta a que el servidor VNC se conecte y entregue el primer fotograma, en milisegundos. El valor predeterminado es 30000.

VS Code

Consulta la documentación de VS Code

Transporte HTTP (Streamable HTTP)

Por defecto, el servidor usa stdio. Para exponerlo a través de HTTP en su lugar:

# Via environment variables
VNC_HOST=192.168.1.100 VNC_PORT=5900 VNC_PASSWORD=secret \
MCP_TRANSPORT=http MCP_PORT=3000 mcp-vnc

# Or via CLI arguments
mcp-vnc --http --port 3000

El endpoint de MCP está entonces disponible en http://localhost:3000/mcp. Ejemplo de configuración del cliente:

{
  "mcpServers": {
    "vnc-controller": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

🛠️ Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas para el control remoto del escritorio:

🖱️ Control del ratón

Ejemplo: vnc_click(x=100, y=200, button="right", double=true)

Ejemplo: vnc_move_mouse(x=500, y=300)

⌨️ Control del teclado

Teclas admitidas:

• Teclas individuales: a, Enter, F1, Escape, Up, Down, Tab, Space

• Combinaciones de teclas: Ctrl+c, Alt+F4, Ctrl+Alt+Delete, Shift+Tab

• Modificadores: Ctrl, Alt, Shift, Super/Win, Meta/Cmd

Ejemplos:

• vnc_key_press(key="Enter")

• vnc_key_press(key="Ctrl+Alt+Delete")

📝 Entrada de texto

Ejemplo: vnc_type_text(text="Hello World!", enter=true)

Ejemplo: vnc_type_multiline(lines=["Line 1", "Line 2", "Line 3"])

📸 Captura de pantalla

Ejemplo: vnc_screenshot(delay=1000) - Espera 1 segundo antes de capturar

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.