kitfactory/pymcpautogui

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

23 stars 4 forks 품질 62 트렌드 10MIT

Repository Install

GUI 조작 MCP 서버

개요

✨ PyMCPAutoGUI는 AI 에이전트(Corsor 또는 기타 MCP 호환 환경과 같은)와 컴퓨터의 그래픽 사용자 인터페이스(GUI) 사이의 브리지를 제공합니다. 그것은 당신의 에이전트 화면을 볼 수 있습니다 vert️, 마우스를 제어 ️️ 및 키보드 ️️, 및 상호 작용 윈도우 , 그냥 인간 사용자처럼! tedious 수동 GUI 작업을 중지하고 AI가 무거운 리프팅을하자. 자동 반복 작업, 테스트 GUI, 또는 강력한 AI 조수를 구축하기 위해 완벽한. * AI 에이전트가 데스크톱 응용 프로그램과 직접 상호 작용하는 힘을 제공합니다. * Cursor 편집기와 같은 MCP 호환 클라이언트와 완벽하게 작동합니다. 플러그 앤 플레이! * 간단한 서버 명령으로 시작하십시오. 심각하게, 그것은 쉽습니다. * 전투 테스트 PyAutoGUI 및 PyGetWindow의 다양한 GUI 자동화 기능을 제공합니다. * 스크린에 스크린 샷 및 위치 이미지를 찍는 도구가 포함되어있어 에이전트가 볼 수 있습니다! * 제어 창 위치, 크기, 상태 (최소, 최대), 및 더 많은.

개요(AI 번역)

**AI Agent의 역량을 최고로 충전하십시오! ** ✨ PyMCPAutoGUI는 AI 에이전트 (Cor 또는 기타 MCP 호환 환경과 같은)와 컴퓨터의 그래픽 사용자 인터페이스 (GUI) 사이의 브리지를 제공합니다. 그것은 당신의 에이전트 화면을 볼 수 있습니다 vert️, 마우스를 제어 ️️ 및 키보드 ️️, 및 상호 작용 윈도우 , 그냥 인간 사용자처럼!

tedious 수동 GUI 작업을 중지하고 AI가 무거운 리프팅을하자. 자동 반복 작업, 테스트 GUI, 또는 강력한 AI 조수를 구축하기 위해 완벽한.

왜 PyMCPAutoGUI를 선택합니까?

** 당신의 대리인을 강화하십시오: ** AI 에이전트가 데스크톱 애플리케이션과 직접 상호 작용할 수 있도록 합니다.
** ✅ 간단한 통합:** Cursor 편집기와 같은 MCP 호환 클라이언트와 완벽하게 작동합니다. 플러그 앤 플레이! ► 사용하기 쉬운: 간단한 서버 명령으로 시작하십시오. 심각하게, 그것은 that 쉽습니다. *** Comprehensive️ Comprehensive️ 종합제어:* 전투 테스트 PyAutoGUI 및 PyGetWindow의 다양한 GUI 자동화 기능을 제공합니다.
** XVideos️ 화면 인식 : ** 스크린에 스크린 샷 및 위치 이미지를 찍는 도구 포함 - 에이전트 * 참조 *!

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

PyMCPAutoGUI 🖱️⌨️🖼️ - GUI Automation via MCP

Supercharge your AI Agent’s capabilities! ✨ PyMCPAutoGUI provides a bridge between your AI agents (like those in Cursor or other MCP-compatible environments) and your computer’s graphical user interface (GUI). It allows your agent to see the screen 👁️, control the mouse 🖱️ and keyboard ⌨️, and interact with windows 🪟, just like a human user!

Stop tedious manual GUI tasks and let your AI do the heavy lifting 💪. Perfect for automating repetitive actions, testing GUIs, or building powerful AI assistants 🤖.

🤔 Why Choose PyMCPAutoGUI?

🤖 Empower Your Agents: Give your AI agents the power to interact directly with desktop applications.
✅ Simple Integration: Works seamlessly with MCP-compatible clients like the Cursor editor. It’s plug and play!
🚀 Easy to Use: Get started with a simple server command. Seriously, it’s that easy.
🖱️⌨️ Comprehensive Control: Offers a wide range of GUI automation functions from the battle-tested PyAutoGUI and PyGetWindow.
🖼️ Screen Perception: Includes tools for taking screenshots and locating images on the screen – let your agent see!
🪟 Window Management: Control window position, size, state (minimize, maximize), and more. Tidy up that desktop!
💬 User Interaction: Display alert, confirmation, and prompt boxes to communicate with the user.

🛠️ Supported Environments

Operating Systems: Windows, macOS, Linux (Requires appropriate dependencies for pyautogui on each OS)
Python: 3.11+ 🐍
MCP Clients: Cursor Editor, any client supporting the Model Context Protocol (MCP)

🚀 Getting Started - It’s Super Easy!

1. Installation (Recommended: Use a Virtual Environment!)

Using a virtual environment keeps your project dependencies tidy.

# Create and activate a virtual environment (example using venv)
python -m venv .venv
# Windows PowerShell
.venv\Scripts\Activate.ps1
# macOS / Linux bash
source .venv/bin/activate

# Install using pip (from PyPI or local source)
# Make sure your virtual environment is active!
pip install pymcpautogui # Or pip install . if installing from local source

(Note: pyautogui might have system dependencies like scrot on Linux for screenshots. Please check the pyautogui documentation for OS-specific installation requirements.)

2. Running the MCP Server

Once installed, simply run the server from your terminal:

# Make sure your virtual environment is activated!
python -m pymcpautogui.server

The server will start and listen for connections (defaulting to port 6789). Look for this output:

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
        "mcpServers": {
            // ... other MCP server configs if any ...
            "PyMCPAutoGUI": {
                // Sets the working directory. ${workspaceFolder} is usually correct.
                "cwd": "${workspaceFolder}",

                // Command to run Python. 'python' works if the venv is active in the terminal
                // where Cursor was launched, or specify the full path.
                "command": "python", // Or ".venv/Scripts/python.exe" (Win) or ".venv/bin/python" (Mac/Linux)

                // Arguments to start the server module.
                "args": ["-m", "pymcpautogui.server"]
            }
            // ... other MCP server configs if any ...
        }
    }