MCP Screenshot Server

🚀 🖼️ MCP 截圖服務器

MCP 截圖服務器是一個輕量級的截圖微服務，與 MCP 兼容，基於 FastAPI 為 Windows 構建。它為 AI 代理和自動化工具提供便利，使其能通過簡單的 HTTP 調用，輕鬆捕獲全屏、特定區域或指定窗口的截圖。

🚀 快速開始

本項目允許 AI 代理和自動化工具通過簡單的 HTTP 調用來捕獲全屏、區域或窗口特定的截圖。以下是使用前的安裝步驟。

✨ 主要特性

• 📸 支持捕獲全屏截圖。
• 🪟 可根據窗口標題捕獲特定窗口的截圖。
• 🔲 允許指定區域 [x, y, 寬度, 高度] 進行截圖。
• 🧠 提供 MCP 兼容的 REST API。
• 🖼️ 支持返回 PNG 或 base64 格式的圖像。
• 🚀 基於 FastAPI 構建，適用於生產環境或 LLM 使用。

📦 安裝指南

git clone https://github.com/yourusername/mcp-screenshot-server.git
cd mcp-screenshot-server
python -m venv .venv
source .venv/bin/activate   # 或 .venv\Scripts\activate 在 Windows 上
pip install -r requirements.txt
uvicorn main:app --reload

💻 使用示例

基礎用法

通過以下 API 調用示例，展示如何使用該服務進行截圖。

POST /screenshot

請求 JSON 正文：

{
  "region": [0, 0, 1280, 720],        // 可選參數
  "window_title": "Untitled - Notepad", // 可選參數
  "base64": true                      // 可選參數 (默認: false)
}

響應（base64 模式）：

{
  "status": "ok",
  "mode": "region",
  "image_format": "base64",
  "image": "<base64-encoded-image>"
}

📚 詳細文檔

使用場景

• 通過模型上下文協議 (MCP) 集成與 LLM 的使用。
• QA 測試自動化流水線。
• 監控和遠程截圖工具。
• 視覺日誌記錄/調試工具用於代理。

貢獻指南

歡迎提交 Pull Request 和 Issues！您可以通過 PR 添加功能或提高跨平臺兼容性（例如 Mac/Linux 支持）。

常見問題

• 在 Linux/macOS 上運行如何？
  當前版本專注於 Windows，但歡迎您擴展它以支持其他平臺。
• 是否經過 MCP 認證？
  此項目旨在儘可能遵循 MCP 規範，以實現與 LLM 代理的最大兼容性。

🔧 技術細節

本項目採用了以下技術棧：

📄 許可證

本項目採用 MIT License，您可以自由使用、分叉和集成。詳細信息請參閱 LICENSE。

🧠 啟發來源

• Anthropic 的 模型上下文協議
• 現實中 LLM 驅動的自動化場景