-
securityA
license-
qualityAn MCP server that bridges AI agents with GUI automation capabilities, allowing them to control mouse, keyboard, windows, and take screenshots to interact with desktop applications.
Last updated -
10
MIT License
mcp-pyautogui-服务器
通过 PyAutoGUI 提供自动化 GUI 测试和控制功能的 MCP（模型上下文协议）服务器。
特征
控制鼠标移动和点击
模拟键盘输入
截取屏幕截图
在屏幕上查找图像
获取屏幕信息
跨平台支持（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"
]
}
}
}
发展
构建和发布
同步依赖项并更新锁文件：
uv sync
构建软件包分发版：
uv build
发布到 PyPI：
uv publish
注意：通过环境变量或命令标志设置 PyPI 凭据：
令牌：
--token或UV_PUBLISH_TOKEN用户名/密码：
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD
调试
为了获得最佳调试体验，请使用 MCP Inspector。
通过 npm 启动 MCP 检查器：
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-pyautogui-server run mcp-pyautogui-server
检查器将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
通过 MCP 服务器提供自动化 GUI 测试和控制功能，支持跨 Windows、macOS 和 Linux 的鼠标移动、键盘输入、屏幕捕获和图像识别。
Related MCP Servers
- -securityAlicense-qualityMCP server that provides computer control capabilities including mouse movements, keyboard actions, screenshot capture with OCR, and window management through a unified API.Last updated -48MIT License
- AsecurityAlicenseAqualityA powerful MCP server that provides interactive user feedback and command execution capabilities for AI-assisted development, featuring a graphical interface with text and image support.Last updated -139MIT License
- -securityFlicense-qualityAn MCP server that allows AI tools like Claude Desktop, Claude Code, and Cursor to visually interact with macOS applications by capturing screenshots and controlling the mouse and keyboard.Last updated -5