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. 圖像分析服務器讀取文件並執行其任務。