MCP Server Microsoft Paint

🚀 MCP 服務器用於 Microsoft Paint

這是一個兼容 JSON - RPC 2.0 的服務器，藉助 Microsoft Commandline Protocol (MCP) 實現對 Microsoft Paint 的控制，為用戶提供便捷的繪圖操作體驗。

🚀 快速開始

本服務器可讓你通過標準輸入發送 JSON - RPC 2.0 請求，進而控制 Microsoft Paint。下面為你介紹構建和運行服務器的步驟。

✨ 主要特性

• 能夠啟動或連接到 Microsoft Paint。
• 支持繪製線條、形狀和像素。
• 可設置顏色和工具屬性。
• 可以對 Paint 窗口進行控制。

📦 安裝指南

環境要求

• 操作系統為 Windows 10/11，且已安裝 Microsoft Paint。
• 安裝 Rust（用於構建服務器）。
• 安裝 Python（用於示例測試客戶端）。

構建服務器

cargo build --release

運行服務器

cargo run --release

💻 使用示例

基礎用法

服務器通過標準輸入接受 JSON - RPC 2.0 請求，並通過標準輸出響應。以下是一些常用方法的請求示例：

initialize

查找或啟動 Microsoft Paint。

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

connect

連接到已運行的 Paint 窗口。

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

draw_line

從一點到另一點繪製線條。

{
  "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
  }
}

高級用法

除了上述方法，服務器還支持以下方法：

• activate_window - 將 Paint 窗口帶到前臺
• get_canvas_dimensions - 返回當前畫布尺寸
• draw_pixel - 繪製單個像素
• draw_shape - 繪製形狀（矩形、橢圓等）
• select_tool - 選擇繪製工具
• set_color - 設置當前顏色
• 以及其他更多功能...

示例測試客戶端

在 final_test.py 提供了一個簡單的測試客戶端，演示如何使用服務器：

python final_test.py

📚 詳細文檔

故障排除

如果遇到連接 Paint 的問題，請按以下步驟操作：

1. 確保 Microsoft Paint 已安裝且可用。
2. 嘗試手動啟動 Paint 再運行服務器。
3. 檢查服務器日誌獲取詳細錯誤信息。

📄 許可證

該項目在 MIT License 下開放源代碼。