PyAutoGUI Server

mcp-pyautogui-server

Un servidor MCP (Model Context Protocol) que proporciona capacidades automatizadas de prueba y control de GUI mediante PyAutoGUI.

Características

• Controlar movimientos y clics del ratón
• Simular entrada de teclado
• Tomar capturas de pantalla
• Encontrar imágenes en pantalla
• Obtener información de la pantalla
• Soporte multiplataforma (Windows, macOS, Linux)

Herramientas

El servidor implementa las siguientes herramientas:

Control del Ratón

• Mover el ratón a coordenadas específicas
• Hacer clic en la posición actual o en una posición especificada
• Operaciones de arrastrar y soltar
• Obtener la posición actual del ratón

Control del Teclado

• Escribir texto
• Pulsar teclas individuales
• Combinaciones de teclas de acceso rápido

Operaciones de Pantalla

• Tomar capturas de pantalla
• Obtener el tamaño de la pantalla
• Encontrar ubicaciones de imágenes en pantalla
• Obtener colores de píxeles

Instalación

Requisitos previos

• Python 3.12+
• PyAutoGUI
• Otras dependencias se instalarán automáticamente

Pasos de instalación

Instale el paquete:

pip install mcp-pyautogui-server

Configuración de Claude Desktop

En MacOS:

~/Library/Application\ Support/Claude/claude_desktop_config.json

En Windows:

%APPDATA%/Claude/claude_desktop_config.json

Configuración de servidores de desarrollo/no publicados:

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

Configuración de servidores publicados:

{
  "mcpServers": {
    "mcp-pyautogui-server": {
      "command": "uvx",
      "args": [
        "mcp-pyautogui-server"
      ]
    }
  }
}

Desarrollo

Compilación y publicación

1. Sincronice las dependencias y actualice el archivo de bloqueo:

uv sync

2. Compile las distribuciones del paquete:

uv build

3. Publique en PyPI:

uv publish

Nota: Establezca las credenciales de PyPI mediante variables de entorno o indicadores de línea de comandos:

• Token: --token o UV_PUBLISH_TOKEN
• Nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Para una mejor experiencia de depuración, use el MCP Inspector.

Inicie el MCP Inspector mediante npm:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-pyautogui-server run mcp-pyautogui-server

El Inspector mostrará una URL a la que puede acceder en su navegador para comenzar a depurar.

Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulte el archivo LICENSE para obtener más detalles.