PyAutoGUI MCP Server

MIT License
6
  • Apple
  • Linux

Integrations

  • Enables cross-platform GUI automation on Linux systems, allowing control of mouse and keyboard input and screen operations

  • Enables cross-platform GUI automation on macOS systems, allowing control of mouse and keyboard input and screen operations

  • Supports launching the MCP Inspector via npm for debugging the server's operations

mcp-pyautogui-서버

PyAutoGUI를 통해 자동화된 GUI 테스트 및 제어 기능을 제공하는 MCP(Model Context Protocol) 서버입니다.

특징

  • 마우스 움직임과 클릭을 제어합니다
  • 키보드 입력 시뮬레이션
  • 스크린샷 찍기
  • 화면에서 이미지 찾기
  • 화면 정보 가져오기
  • 크로스 플랫폼 지원(Windows, macOS, Linux)

도구

서버는 다음 도구를 구현합니다.

마우스 제어

  • 마우스를 특정 좌표로 이동
  • 현재 위치 또는 지정된 위치를 클릭하세요
  • 드래그 앤 드롭 작업
  • 현재 마우스 위치 가져오기

키보드 제어

  • 텍스트를 입력하세요
  • 개별 키를 누르세요
  • 단축키 조합

화면 작업

  • 스크린샷 찍기
  • 화면 크기 가져오기
  • 화면에서 이미지 위치 찾기
  • 픽셀 색상 가져오기

설치

필수 조건

  • 파이썬 3.12+
  • 파이오토GUI
  • 다른 종속성은 자동으로 설치됩니다.

설치 단계

패키지를 설치하세요:

지엑스피1

클로드 데스크톱 구성

MacOS의 경우:

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

Windows의 경우:

%APPDATA%/Claude/claude_desktop_config.json

개발/미공개 서버 구성:

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

게시된 서버 구성:

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

개발

건축 및 출판

  1. 종속성 동기화 및 잠금 파일 업데이트:
uv sync
  1. 패키지 배포 빌드:
uv build
  1. PyPI에 게시:
uv publish

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정하세요.

  • 토큰: --token 또는 UV_PUBLISH_TOKEN
  • 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME--password / UV_PUBLISH_PASSWORD

디버깅

최상의 디버깅 환경을 위해 MCP Inspector를 사용하세요.

npm을 통해 MCP Inspector를 실행합니다.

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

검사기는 디버깅을 시작하기 위해 브라우저에서 액세스할 수 있는 URL을 표시합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

-
security - not tested
A
license - permissive license
-
quality - not tested

Windows, macOS, Linux에서 마우스 움직임, 키보드 입력, 화면 캡처, 이미지 인식을 지원하는 MCP 서버를 통해 자동화된 GUI 테스트 및 제어 기능을 제공합니다.

  1. Features
    1. Tools
      1. Mouse Control
      2. Keyboard Control
      3. Screen Operations
    2. Installation
      1. Prerequisites
      2. Install Steps
      3. Claude Desktop Configuration
    3. Development
      1. Building and Publishing
      2. Debugging
    4. License

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        A MCP server that provides browser automation tools, allowing users to navigate websites, take screenshots, click elements, fill forms, and execute JavaScript through Playwright.
        Last updated -
        Python
        Apache 2.0
        • Apple
      • A
        security
        A
        license
        A
        quality
        Simple MCP Server to enable a human-in-the-loop workflow in tools like Cline and Cursor. This is especially useful for developing desktop applications that require complex user interactions to test.
        Last updated -
        1
        13
        Python
        MIT License
        • Linux
        • Apple
      • A
        security
        A
        license
        A
        quality
        The first open-source MCP server that enables AI to fully control remote macOS systems.
        Last updated -
        6
        55
        Python
        MIT License
        • Apple
      • -
        security
        A
        license
        -
        quality
        An MCP server that bridges AI agents with GUI automation capabilities, allowing them to control mouse, keyboard, windows, and take screenshots to interact with desktop applications.
        Last updated -
        Python
        MIT License
        • Apple
        • Linux

      View all related MCP servers

      ID: qjvdfenpis