JinDaGe - mcp-server-microsoft-paint MCP Details

article

README

🚀 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 的问题，请按以下步骤操作：

确保 Microsoft Paint 已安装且可用。
尝试手动启动 Paint 再运行服务器。
检查服务器日志获取详细错误信息。

📄 许可证

该项目在 MIT License 下开放源代码。

mcp-server-microsoft-paint