# hetaoBackend
## 基本信息
- Slug: `hetaobackend-mcp-pyautogui-server`
- Source: modelscope
- Publisher: @hetaoBackend/mcp-pyautogui-server
- Categories: testing-and-qa-tools / os-automation / app-automation
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@hetaoBackend/mcp-pyautogui-server
## 简介
暂无描述。
## MCP Server 详情

# mcp-pyautogui-server

[![smithery badge](https://smithery.ai/badge/@hetaoBackend/mcp-pyautogui-server)](https://smithery.ai/server/@hetaoBackend/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 文件。