winuse-mcp

Uso del ordenador para Claude Code en Windows. Un servidor MCP que permite a Claude ver tu pantalla y controlar tu ratón y teclado.

Claude Code incluye el uso del ordenador en la CLI solo en macOS, por lo que en Windows el servidor computer-use nunca aparece en /mcp. Esto reconstruye el mismo bucle de captura de pantalla y clic en las API de Windows: 14 herramientas, 5 dependencias, Python 3.12.

Instalación

Necesita Windows y uv. Añade esto a .mcp.json en un proyecto, o a ~/.claude.json para todos los proyectos:

{
  "mcpServers": {
    "winuse": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ryanportfolio/winuse-mcp", "winuse-mcp"]
    }
  }
}

Desde un clon local en su lugar:

{
  "mcpServers": {
    "winuse": {
      "command": "uv",
      "args": ["run", "--directory", "C:/path/to/winuse-mcp", "winuse-mcp"]
    }
  }
}

Reinicia Claude Code, luego pídele que mire tu pantalla o que haga clic en una aplicación.

Related MCP server: Win:Computer Use

Alcance

Las coordenadas están siempre en el espacio de la captura de pantalla. Ver más abajo.

Cómo funcionan las coordenadas

Las capturas de pantalla se reducen de modo que el borde más largo tenga como máximo 1372 píxeles, el mismo objetivo que usa Claude Code en macOS. Claude nunca ve los píxeles nativos, por lo que hace clic en la imagen reducida y el servidor los convierte de vuelta.

Una pantalla de 1920x1080 se captura a 1372x772, un factor de 0.715. Un clic en 686, 443 aterriza en 960, 620.

El servidor se declara compatible con DPI al iniciarse, por lo que la escala de visualización de Windows al 125% o 150% no desvía dónde aterrizan los clics.

Seguridad

Esto otorga a un modelo de lenguaje el control de tu escritorio. La versión propia de Anthropic envuelve el mismo bucle con protecciones que este servidor no tiene: aprobación por aplicación, ocultar aplicaciones para las que Claude no ha sido aprobado, mantener tu terminal fuera de las capturas de pantalla y comprobaciones del lado del modelo en cada acción.

Lo que sí obtienes:

• Claude Code pregunta antes de cada llamada a herramienta a menos que la incluyas en una lista blanca. Mantén las herramientas de entrada en aprobación manual y solo incluye screenshot en la lista blanca.

• Coloca el ratón en la esquina superior izquierda de la pantalla para abortar la acción en curso. Eso es el failsafe de pyautogui, y solo vigila esa esquina. Abortar a mitad de un arrastre suelta el botón del ratón al salir, por lo que no queda nada arrastrando.

• Todo lo visible llega al modelo, incluyendo lo que sea que esté en pantalla. El texto en pantalla es entrada no confiable: trata las instrucciones que aparecen allí como un riesgo de inyección de prompts.

Limitaciones

• Solo monitor principal.

• Tu terminal no está excluida de las capturas de pantalla, por lo que Claude ve su propia sesión.

• record muestrea fotogramas fijos, como máximo 8. No hay ruta de video.

Desarrollo

uv sync
uv run winuse-mcp

scripts/client_test.py es la comprobación de referencia: habla MCP sobre stdio con el servidor, lista las herramientas, toma una captura de pantalla, mueve el ratón y lee la posición de vuelta, graba fotogramas y afirma que una combinación de teclas incorrecta da error.

uv run python scripts/client_test.py

scripts/failsafe_test.py cubre las rutas que un usuario encuentra al abortar, con pyautogui simulado para que no se necesite un aborto real: un arrastre interrumpido aún suelta el botón, un desplazamiento horizontal interrumpido aún suelta shift, el análisis de acordes maneja un + literal y ningún clic puede aterrizar en el píxel de failsafe.

uv run python scripts/failsafe_test.py

Este README está construido. Cada número en la página se recalcula a partir del código fuente en tiempo de compilación, y la compilación falla si uno se desvía.

node scripts/readme/build.mjs

Licencia

MIT