项目简介

本项目 'mcp-server-microsoft-paint' 是一个基于 Model Context Protocol (MCP) 理念构建的服务器，它允许您通过 JSON-RPC 2.0 协议远程控制 Windows 11 操作系统自带的画图程序。该服务器充当 MCP 服务器的角色，接收来自客户端的指令，进而操作画图程序，实现自动化绘图和图像编辑等任务。

主要功能点

启动和连接画图程序: 服务器可以自动启动新的画图程序实例，或者连接到已经运行的画图程序。
图形绘制: 支持绘制直线、像素、矩形、椭圆等多种基本图形，并可以设置颜色、线条粗细和填充样式。
工具选择: 允许程序自动选择画笔、橡皮擦、填充等画图工具。
窗口控制: 可以激活画图程序窗口，使其置于前台。
画布操作: 支持获取画布尺寸等信息。

安装步骤

环境准备:
- 确保您的操作系统为 Windows 10 或 Windows 11。
- 安装 Rust 编程语言环境。
- （可选）安装 Python，以便运行仓库中提供的测试客户端示例。
构建服务器:
- 克隆或下载此 GitHub 仓库到本地。
- 打开命令提示符或 PowerShell，切换到仓库根目录。
- 运行命令 'cargo build --release' 以 Release 模式编译服务器程序。编译成功后，可执行文件 'mcp-server-microsoft-paint.exe' 将位于 'target/release' 目录下。

服务器配置

MCP 客户端需要配置以下 JSON 格式信息以连接到此 MCP 服务器。请根据实际情况修改 'command' 字段指向 'mcp-server-microsoft-paint.exe' 的路径。

{
  "server name": "Microsoft Paint MCP Server",
  "command": "target/release/mcp-server-microsoft-paint.exe",
  "args": []
}

配置参数说明:

'server name': 服务器的名称，可以自定义，用于在 MCP 客户端中标识该服务器。
'command': 重要：MCP 服务器可执行文件的路径。请根据实际 'mcp-server-microsoft-paint.exe' 文件所在位置填写。如果可执行文件在 PATH 环境变量包含的路径中，则只需填写文件名 'mcp-server-microsoft-paint.exe'。
'args': 启动服务器时需要传递的命令行参数，本项目服务器无需额外参数，因此为空数组 '[]'。

基本使用方法

启动服务器:
- 打开命令提示符或 PowerShell，切换到仓库根目录。
- 运行命令 'cargo run --release' 启动服务器。服务器程序将监听标准输入 (stdin) 接收 JSON-RPC 请求，并通过标准输出 (stdout) 返回响应。
客户端发送请求:
- MCP 客户端 (例如，用户自行开发的 LLM 应用或使用仓库中提供的 Python 测试客户端) 需要按照 JSON-RPC 2.0 协议格式构造请求，并通过标准输入发送给服务器。
- 请求示例 (初始化服务器)：
```
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {}
}
```
- 服务器会将处理结果以 JSON-RPC 2.0 响应格式通过标准输出返回给客户端。
测试客户端:
- 仓库中提供了多个 Python 测试客户端脚本 ('final_test.py', 'simple_test_client.py' 等) 用于演示如何与服务器交互。
- 运行测试客户端 (例如 'python final_test.py') 可以发送预设的 JSON-RPC 请求，测试服务器功能。请参考这些示例脚本了解更多请求格式和使用方法。

注意事项

本服务器目前仅支持 Windows 11 画图程序。
确保在运行服务器前，Windows 画图程序已正确安装。
服务器通过标准输入/输出进行通信，适用于与支持 Stdio 传输协议的 MCP 客户端集成。

关键词