MCP Server Microsoft Paint

🚀 MCP Server for Microsoft Paint

A JSON-RPC 2.0 compatible server that controls Microsoft Paint via the Microsoft Commandline Protocol (MCP).

🚀 Quick Start

This is a server compatible with JSON-RPC 2.0, which controls Microsoft Paint through the Microsoft Commandline Protocol (MCP).

✨ Features

• Start or connect to Microsoft Paint.
• Draw lines, shapes, and pixels.
• Set colors and tool properties.
• Control the Paint window.

📦 Installation

Requirements

• Windows 10/11 with Microsoft Paint installed.
• Rust (for building the server).
• Python (for the example test client).

Build and Run

To build the server:

cargo build --release

To run the server:

cargo run --release

The server accepts JSON-RPC 2.0 requests via standard input and responds via standard output.

📚 Documentation

JSON-RPC Methods

initialize

Find or start Microsoft Paint. Request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {}
}

connect

Connect to a running Paint window. Request:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "connect",
  "params": {
    "client_id": "your-client-id",
    "client_name": "Your Client Name"
  }
}

draw_line

Draw a line from one point to another. Request:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "draw_line",
  "params": {
    "start_x": 100,
    "start_y": 100,
    "end_x": 300,
    "end_y": 100,
    "color": "#FF0000",
    "thickness": 3
  }
}

Other Methods

• activate_window - Bring the Paint window to the foreground.
• get_canvas_dimensions - Return the current canvas dimensions.
• draw_pixel - Draw a single pixel.
• draw_shape - Draw shapes (rectangles, ellipses, etc.).
• select_tool - Select a drawing tool.
• set_color - Set the current color.
• And many more...

💻 Usage Examples

Basic Usage

A simple test client is provided in final_test.py to demonstrate how to use the server:

python final_test.py

🔧 Troubleshooting

If you encounter issues connecting to Paint:

1. Ensure that Microsoft Paint is installed and available.
2. Try manually starting Paint and then running the server.
3. Check the server logs for detailed error information.

📄 License

This project is open-source under the MIT License.