返回 MCP 目录
public公开dns本地运行

mcp-server-microsoft-paint

一个通过JSON-RPC 2.0协议控制微软画图的服务器,支持启动画图程序、绘制图形、设置颜色和工具属性等功能。

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 的问题,请按以下步骤操作:

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

📄 许可证

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

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端