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

此项目提供了一个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主机可以根据返回的路径处理截图。

工具

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

设置说明

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

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

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

文件结构

• 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. 图像分析服务器读取文件并执行其任务。