MCP Anydesk

MCP AnyDesk Server

Servidor MCP para administracion remota de servidores Windows a traves de sesiones AnyDesk anidadas (Local -> AnyDesk -> AnyDesk -> Servidor).

Inyecta comandos PowerShell como keystrokes y lee la salida via OCR. Diseñado para entornos donde no se puede instalar agentes en el servidor remoto.

Claude nunca presiona Enter. El operador siempre confirma manualmente.

Instalacion rapida

git clone https://github.com/DraxGfx/mcp-anydesk.git
cd mcp-anydesk
powershell -ExecutionPolicy Bypass -File install.ps1

El instalador verifica Python, crea el entorno virtual, instala dependencias, corre preflight check y configura Claude Desktop automaticamente.

Al finalizar, reinicia Claude Desktop.

Instalacion manual

git clone https://github.com/DraxGfx/mcp-anydesk.git
cd mcp-anydesk
python -m venv .venv
.venv\Scripts\pip.exe install -e .

Tesseract OCR (opcional, necesario para lectura de pantalla)

winget install UB-Mannheim.TesseractOCR

O descargar desde: https://github.com/UB-Mannheim/tesseract/wiki

Configurar Claude Desktop

Editar %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "anydesk": {
      "command": "C:\\dev\\mcp-anydesk\\.venv\\Scripts\\python.exe",
      "args": ["-m", "mcp_anydesk_server"]
    }
  }
}

Reemplazar C:\\dev\\mcp-anydesk con la ruta real del proyecto.

Reiniciar Claude Desktop.

Caracteristicas

• Inyeccion via KEYEVENTF_UNICODE — layout-independent, funciona con cualquier

teclado (EN-US, ES-PE, etc.). Caracter por caracter via SendInput

• Lectura OCR — Tesseract + OpenCV con retry adaptativo y zoom 4x
• Modo Base64 — wrapper lite (sin bootstrap) y full (con PII sanitization)

con validacion CRC SHA256

• Screenshots JPEG — cap de 15KB, guardados a disco (sin base64 en response

para evitar lag en Claude Desktop)

• Sanitizacion PII opcional — dual-layer: PowerShell remoto + Python post-OCR.

Redacta IPs, emails, DOMAIN\user, SIDs

• Validacion de quotes — detecta comillas desbalanceadas antes de inyectar
• Sesiones nombradas — multiples ventanas AnyDesk pinneadas simultaneamente
• Recipes — secuencias predefinidas para health check, VMs, red, servicios
• Auditoria — historial en memoria + log en disco + export a markdown
• Compatible con Hyper-V y VMware PowerCLI

Uso

1. Abrir AnyDesk y conectar a la sesion remota
2. Abrir Claude Desktop
3. Claude llama initialize_session — pinnea la ventana AnyDesk
4. (Opcional) Decir "bootstrap" — activa sanitizacion PII en 9 pasos
5. Trabajar: Claude inyecta comandos, el operador presiona Enter, Claude lee el output

Tools disponibles (18)

Limitaciones conocidas

• Ctrl+C programatico no funciona — AnyDesk no reenvía Ctrl+C de SendInput

como señal de interrupcion. send_cancel enfoca la ventana para que el operador presione Ctrl+C manualmente.

• OCR no es perfecto — caracteres pueden leerse mal en resoluciones bajas.

Usar capture_screenshot o modo Base64 para output critico.

• Focus drift — no mover el mouse ni cambiar de ventana durante la inyeccion.

Seguridad

• No auto-Enter: ninguna herramienta presiona Enter
• Validacion de quotes: comillas desbalanceadas se detectan antes de inyectar
• Sanitizacion PII dual-layer: PowerShell remoto + Python post-OCR
• Audit log append-only: cada comando queda registrado en disco
• Sin clipboard: inyeccion siempre por keystrokes

Documentacion

Licencia

MIT