返回 MCP 目录
public公开dns本地运行

localplay-mcp-server

一个本地运行的MCP服务器项目,实现鼠标控制功能,支持移动、点击、拖拽和滚动操作。

article

README

🚀 LocalPlay MCP 服务器

本项目用于在本地运行 MCP(模型上下文协议)服务器,可实现鼠标控制功能,为用户提供便捷的本地操作体验。

🚀 快速开始

启动服务器

运行以下命令启动 MCP 开发服务器:

    "localplay-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/localplay-mcp-server",
        "run",
        "server.py"
      ]
    }

使用 Docker

您也可以使用 Docker 运行服务器:

# 构建 Docker 镜像
docker build -t localplay-mcp-server .

# 运行 Docker 容器
docker run -p 8080:8080 localplay-mcp-server

✨ 主要特性

当前服务器实现了以下鼠标控制功能:

  • 移动鼠标:将鼠标移动到指定坐标位置
  • 鼠标点击:在当前位置或指定位置执行鼠标点击操作
  • 鼠标拖拽:从一个位置拖拽到另一个位置
  • 鼠标滚动:执行鼠标滚轮滚动操作

📦 安装指南

使用 uv 安装依赖:

uv add "mcp[cli]" pyautogui

或者使用 pip:

pip install "mcp[cli]" pyautogui

💻 使用示例

基础用法

  1. 移动鼠标:将鼠标移动到指定坐标,例如 (100, 200)
  2. 鼠标点击:在当前位置或指定位置进行点击操作
  3. 鼠标拖拽:从起始位置拖拽到目标位置
  4. 鼠标滚动:执行向上或向下的滚动操作

📄 许可证

本项目基于 MIT 许可证开源。详情请查看 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端