PyAutoGUI Server

mcp-pyautogui-server

Um servidor MCP (Model Context Protocol) que fornece capacidades automatizadas de teste e controle de GUI através do PyAutoGUI.

Recursos

• Controlar movimentos e cliques do mouse
• Simular entrada de teclado
• Tirar capturas de tela
• Encontrar imagens na tela
• Obter informações da tela
• Suporte multiplataforma (Windows, macOS, Linux)

Ferramentas

O servidor implementa as seguintes ferramentas:

Controle do Mouse

• Mover o mouse para coordenadas específicas
• Clicar na posição atual ou em uma posição especificada
• Operações de arrastar e soltar
• Obter a posição atual do mouse

Controle do Teclado

• Digitar texto
• Pressionar teclas individuais
• Combinações de atalhos

Operações de Tela

• Tirar capturas de tela
• Obter o tamanho da tela
• Encontrar localizações de imagens na tela
• Obter cores de pixels

Instalação

Pré-requisitos

• Python 3.12+
• PyAutoGUI
• Outras dependências serão instaladas automaticamente

Passos de Instalação

Instale o pacote:

pip install mcp-pyautogui-server

Configuração do Claude Desktop

No MacOS:

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

No Windows:

%APPDATA%/Claude/claude_desktop_config.json

Configuração de Servidores em Desenvolvimento/Não Publicados:

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

Configuração de Servidores Publicados:

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

Desenvolvimento

Compilação e Publicação

1. Sincronize as dependências e atualize o arquivo de bloqueio:

uv sync

2. Compile as distribuições do pacote:

uv build

3. Publique no PyPI:

uv publish

Nota: Defina as credenciais do PyPI por meio de variáveis de ambiente ou flags de comando:

• Token: --token ou UV_PUBLISH_TOKEN
• Nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Para a melhor experiência de depuração, use o MCP Inspector.

Inicie o MCP Inspector via npm:

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

O Inspector exibirá uma URL que você pode acessar no seu navegador para começar a depurar.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.