Screenshot

🚀 屏幕截图服务器（文件路径聚焦）

本项目提供了一个MCP（模块化通信协议）服务器，其核心功能是捕获屏幕截图，并将截图保存到客户端（主机）指定的文件路径，方便其他进程或AI助手使用。

🚀 快速开始

此服务器采用基于文件路径的工作流程，解决了AI助手通过MCP发送屏幕截图图像数据不可靠的问题。以下为你介绍两种工作流：

推荐工作流（WSL主机 -> Windows服务器）

1. 一个MCP主机（如运行在WSL中的AI助手）调用save_screenshot_to_host_workspace工具，并提供其WSL工作站路径作为参数。
2. 运行在Windows上的服务器捕获屏幕。
3. 服务器将收到的WSL路径转换为Windows可访问的UNC路径（例如：\\wsl$\Distro\path）。
4. 服务器将截图保存到主机WSL文件系统中的指定位置，通过UNC路径访问。
5. 服务器返回"success"或"failed:... "。
6. MCP主机知道截图已保存在其工作区（如果在参数中指定了子目录，则保存在指定的子目录）。
7. MCP主机可以将WSL路径传递给另一个专门的MCP服务器（运行在WSL中）进行图像分析。

通用替代工作流

1. MCP主机调用take_screenshot_and_return_path，可选指定文件名。
2. 服务器将截图保存到其本地images/目录。
3. 服务器返回文件路径。
4. MCP主机可以根据返回的路径处理截图。

✨ 主要特性

• 提供多种工具，满足不同的截图保存和获取需求。
• 采用可靠的基于文件路径的工作流程，确保截图数据的可靠传输。

📦 安装指南

安装依赖

在Windows上安装Python，并通过uv安装项目依赖：uv sync .

配置MCP主机

更新MCP主机配置以启动此服务器：

{
  "mcpServers": {
    "Screenshot-server": {
      "command": "powershell.exe",
      "args": [
        "-Command",
        "cd '<YOUR_WINDOWS_PROJECT_PATH>'; & '<YOUR_WINDOWS_UV_PATH>' run screenshot.py"
      ]
    }
    // ... 其他服务器 ...
  }
}

📚 详细文档

工具说明

• save_screenshot_to_host_workspace：将截图保存到主机WSL工作站路径。
• take_screenshot_and_return_path：返回截图的文件路径。
• capture_screen：捕获当前屏幕并返回Base64编码的图像数据。

文件结构

• screenshot.py：核心MCP服务器脚本。
• README.md：此文档文件。
• pyproject.toml：项目定义和依赖项，用于uv。
• uv.lock：依赖锁定文件。
• .gitignore：Git忽略配置。
• .python-version：（可选）Python版本规范器。
• server.log：服务器生成的日志文件。
• images/：take_screenshot_and_return_path的默认目录。

💻 使用示例

基础用法

1. 在WSL中，AI助手获取其当前工作站路径（例如：/home/user/current_project）。
2. AI助手使用use_mcp_tool调用save_screenshot_to_host_workspace到Screenshot-server，传递host_workspace_path="/home/user/current_project"和可选的name参数。
3. 收到"success"响应。
4. AI助手知道截图现在位于/home/user/current_project/workspace_screenshot.jpg（或指定的文件名）。
5. AI助手使用use_mcp_tool调用运行在WSL中的图像分析服务器/工具，传递WSL路径/home/user/current_project/workspace_screenshot.jpg。
6. 图像分析服务器读取文件并执行其任务。