AI导哈

GUI自动化测试服务

一个基于PyAutoGUI的MCP服务器，提供跨平台的GUI自动化测试和控制功能，包括鼠标控制、键盘模拟、屏幕操作等。

  • by hetaoBackend
  • Python
  • 本地部署
  • 45 星标
  • 更新于
在 GitHub 查看 hetaoBackend/mcp-pyautogui-server

使用说明

mcp-pyautogui服务器

MCP（模型上下文协议）服务器，通过PyAutoGUI提供自动GUI测试和控制功能。

特性

  • 控制鼠标移动和点击
  • 模拟键盘输入
  • 截图
  • 在屏幕上查找图像
  • 获取屏幕信息
  • 跨平台支持（Windows、macOS、Linux）

工具

服务器实现了以下工具：

鼠标控制

  • 将鼠标移动到特定坐标
  • 点击当前或指定位置
  • 拖放操作
  • 获取当前鼠标位置

键盘控制

  • 键入文本
  • 按各个键
  • 热键组合

屏幕操作

  • 截图
  • 获取屏幕尺寸
  • 在屏幕上查找图像位置
  • 获取像素颜色

安装

先决条件

  • Python 3.12+
  • PyAutoGUI
  • 其他依赖项将自动安装

安装步骤

安装软件包：

pip install mcp-pyautogui-server

Claude桌面配置

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

通过npm启动MCP检查器：

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

检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP