Pyautogui

🚀 mcp-pyautogui-server

一個基於模型上下文協議（Model Context Protocol）的服務器，藉助PyAutoGUI實現自動化的圖形用戶界面測試與控制功能，為跨平臺的圖形界面操作提供便利。

🚀 快速開始

mcp-pyautogui-server 是一個基於模型上下文協議的服務器，通過 PyAutoGUI 提供自動化的圖形用戶界面測試和控制功能。它支持跨平臺使用，可在 Windows、macOS、Linux 系統上運行。

✨ 主要特性

• 控制鼠標移動和點擊
• 模擬鍵盤輸入
• 截取屏幕截圖
• 在屏幕上查找圖像
• 獲取屏幕信息
• 跨平臺支持（Windows、macOS、Linux）

📦 安裝指南

先決條件

• Python 3.12+
• PyAutoGUI
• 其他依賴項會自動安裝

安裝步驟

安裝包：

pip install mcp-pyautogui-server

Claude Desktop 配置

在 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 檢查器。

通過 npm 啟動 MCP 檢查器：

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

檢查器會顯示一個 URL，您可以在瀏覽器中訪問該 URL 以開始調試。

📄 許可證

該項目遵循 MIT 許可證 - 查看 LICENSE 文件瞭解詳細信息。