mcpField
L
LocalPlay MCP Server

LocalPlay MCP Server

Local
github.com/hfyyddOther0Updated 78w ago
Repository

About LocalPlay MCP Server

LocalPlay MCP Server is a local MCP server for mouse control, intended for clients that need to operate a mouse through MCP. It supports movement, clicks, dragging, and scrolling.

Key features

  1. 01Move mouse to coordinates
  2. 02Click at current or specified position
  3. 03Drag between positions
  4. 04Scroll the mouse wheel

Use cases

  1. 01Move the pointer to given coordinates
  2. 02Click at the current or a specified position
  3. 03Drag from a start to a target position
  4. 04Scroll up or down

MCP support

It provides a local MCP server that exposes mouse control to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "localplay": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}
Run commanddocker run -i --rm build

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocibuild

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

LocalPlay MCP Server

用于本地运行 MCP (Model Context Protocol) 服务器的项目，实现鼠标控制功能。

A project for running a local MCP (Model Context Protocol) server that implements mouse control functionality.

安装 | Installation

使用 uv 安装依赖：

Install dependencies using uv:

uv add "mcp[cli]" pyautogui

或者使用 pip：

Or using pip:

pip install "mcp[cli]" pyautogui

使用方法 | Usage

启动服务器 | Starting the Server

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

Run the following command to start the MCP development server:

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

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

You can also use Docker to run the server:

# 构建Docker镜像 | Build the Docker image
docker build -t localplay-mcp-server .

# 运行Docker容器 | Run the Docker container
docker run -p 8080:8080 localplay-mcp-server
服务器功能 | Server Features

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

The server currently implements the following mouse control features:

  • 移动鼠标 | Move Mouse: 将鼠标移动到指定坐标位置 | Move the mouse to a specified coordinate position
  • 鼠标点击 | Mouse Click: 在当前或指定位置执行鼠标点击操作 | Perform mouse click operations at the current or specified position
  • 鼠标拖拽 | Mouse Drag: 从一个位置拖拽到另一个位置 | Drag from one position to another
  • 鼠标滚动 | Mouse Scroll: 执行鼠标滚轮滚动操作 | Perform mouse wheel scrolling operations
使用示例 | Usage Examples
  1. 移动鼠标 | Move Mouse: 将鼠标移动到指定坐标，例如 (100, 200) | Move the mouse to specified coordinates, e.g. (100, 200)
  2. 鼠标点击 | Mouse Click: 在当前位置或指定位置进行点击操作 | Click at the current or specified position
  3. 鼠标拖拽 | Mouse Drag: 从起始位置拖拽到目标位置 | Drag from a starting position to a target position
  4. 鼠标滚动 | Mouse Scroll: 执行向上或向下的滚动操作 | Perform scrolling operations up or down

许可证 | License

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

This project is open-sourced under the MIT License. See the LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.