mcp-server-microsoft-paint

MCP Server for Microsoft Paint

A JSON-RPC 2.0 compatible server for controlling Microsoft Paint through the Microsoft Commandline Protocol (MCP).

Features

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

Requirements

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

Building and Running

To build the server:

cargo build --release

To run the server:

cargo run --release

The server accepts JSON-RPC 2.0 requests via stdin and responds via stdout.

JSON-RPC Methods

initialize

Finds or launches Microsoft Paint.

Request:

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

connect

Connects to an already running Paint window.

Request:

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

draw_line

Draws 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 - Brings the Paint window to the foreground
• get_canvas_dimensions - Returns the current canvas size
• draw_pixel - Draws a single pixel
• draw_shape - Draws a shape (rectangle, ellipse, etc.)
• select_tool - Selects a drawing tool
• set_color - Sets the current color
• And more...

Example Test Client

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 with the server connecting to Paint:

1. Make sure Microsoft Paint is installed and accessible
2. Try manually launching Paint before starting the server
3. Check the server logs for detailed error messages

License

This project is available under the MIT License.