mcp-pyautogui-서버

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

특징

• 마우스 움직임과 클릭을 제어합니다

• 키보드 입력 시뮬레이션

• 스크린샷 찍기

• 화면에서 이미지 찾기

• 화면 정보 가져오기

• 크로스 플랫폼 지원(Windows, macOS, Linux)

Related MCP server: Computer Use MCP

도구

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

마우스 제어

• 마우스를 특정 좌표로 이동

• 현재 위치 또는 지정된 위치를 클릭하세요

• 드래그 앤 드롭 작업

• 현재 마우스 위치 가져오기

키보드 제어

• 텍스트를 입력하세요

• 개별 키를 누르세요

• 단축키 조합

화면 작업

• 스크린샷 찍기

• 화면 크기 가져오기

• 화면에서 이미지 위치 찾기

• 픽셀 색상 가져오기

설치

필수 조건

• 파이썬 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

2. 패키지 배포 빌드:

uv build

3. 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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.