MCP Pyautogui Server

🚀 mcp-pyautogui-server

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

🚀 快速開始

本服務器基於MCP（模型上下文協議）構建，可通過PyAutoGUI達成自動化的GUI測試與控制。藉助它，你能夠輕鬆控制鼠標、模擬鍵盤輸入、截取屏幕等。

✨ 主要特性

• 控制鼠標移動和點擊
• 模擬鍵盤輸入
• 截取屏幕截圖
• 在屏幕上查找圖像
• 獲取屏幕信息
• 支持跨平臺（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 文件。