mcp-pyautogui-server

这是一个通过PyAutoGUI提供自动化GUI测试和控制功能的MCP（Model Context Protocol）服务器。

功能

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

工具

该服务器实现了以下工具：

鼠标控制

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

键盘控制

• 输入文本
• 按下单独的按键
• 组合键

屏幕操作

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

安装

前提条件

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

安装步骤

安装包：

bash pip install mcp-pyautogui-server

Claude Desktop 配置

在 macOS 上： bash ~/Library/Application Support/Claude/claude_desktop_config.json

在 Windows 上： bash %APPDATA%/Claude/claude_desktop_config.json

开发/未发布的服务器配置： json { "mcpServers": { "mcp-pyautogui-server": { "command": "uv", "args": [ "--directory", "/path/to/mcp-pyautogui-server", "run", "mcp-pyautogui-server" ] } } }

已发布的服务器配置： json { "mcpServers": { "mcp-pyautogui-server": { "command": "uvx", "args": [ "mcp-pyautogui-server" ] } } }

开发

构建和发布

1. 同步依赖项并更新锁文件： bash uv sync

2. 构建包分发： bash uv build

3. 发布到 PyPI： bash uv publish

注意：通过环境变量或命令标志设置 PyPI 凭证：

• Token: --token 或 UV_PUBLISH_TOKEN
• 用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

为了获得最佳调试体验，请使用 MCP Inspector。

通过 npm 启动 MCP Inspector：

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

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

许可

该项目根据 MIT 许可证许可 - 详情请参阅 LICENSE 文件。