Localplay MCP Server

🚀 LocalPlay MCP Server

A project for running an MCP (Model Context Protocol) server locally, enabling mouse control functionality.

🚀 Quick Start

This project allows you to run an MCP server locally and provides mouse control features.

📦 Installation

You can install the dependencies using uv:

uv add "mcp[cli]" pyautogui

Or use pip:

pip install "mcp[cli]" pyautogui

💻 Usage Examples

Start the Server

Run the following command to start the MCP development server:

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

Use Docker

You can also run the server using Docker:

# Build the Docker image
docker build -t localplay-mcp-server .

# Run the Docker container
docker run -p 8080:8080 localplay-mcp-server

Server Features

The current server implements the following mouse control functions:

• Move the mouse: Move the mouse to the specified coordinate position.
• Mouse click: Perform a mouse click operation at the current position or a specified position.
• Mouse drag: Drag from one position to another.
• Mouse scroll: Perform a mouse wheel scrolling operation.

Basic Usage

1. Move the mouse: Move the mouse to the specified coordinates, for example, (100, 200).
2. Mouse click: Click at the current position or a specified position.
3. Mouse drag: Drag from the starting position to the target position.
4. Mouse scroll: Perform an upward or downward scrolling operation.

📄 License

This project is open - source under the MIT license. For details, please check the LICENSE file.