mcp-screenshot-server

🚀 🖼️ MCP 截图服务器

MCP 截图服务器是一个轻量级的截图微服务，与 MCP 兼容，专为 Windows 系统使用 FastAPI 构建。它能让 AI 代理和自动化工具通过简单的 HTTP 调用，轻松捕获全屏、特定区域或特定窗口的截图。

🚀 快速开始

按照以下步骤启动 MCP 截图服务器：

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

✨ 主要特性

• 📸 可捕获全屏截图。
• 🪟 能通过窗口标题捕获特定窗口的截图。
• 🔲 支持指定区域 [x, y, 宽度, 高度] 进行截图。
• 🧠 具备 MCP 兼容的 REST API。
• 🖼️ 可返回 PNG 或 base64 格式的图像。
• 🚀 基于 FastAPI 构建，适用于生产环境或 LLM 使用。

📚 详细文档

🧠 使用场景

• 通过模型上下文协议 (MCP) 集成与 LLM 的使用。
• 可用于 QA 测试自动化流水线。
• 能作为监控和远程截图工具。
• 可作为视觉日志记录/调试工具供代理使用。

🔌 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>"
}

🔧 技术细节

本项目使用的技术栈如下：

• Python 3.11+
• FastAPI
• mss 或 pyautogui 截图工具
• pillow 图像处理库
• pygetwindow 窗口匹配（可选）

📄 许可证

本项目采用 MIT 许可证。您可以自由使用、分叉和集成。详细信息请参阅 LICENSE。

📬 贡献指南

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

🙋 常见问题

• 在 Linux/macOS 上运行如何？
  当前版本专注于 Windows，但欢迎您扩展它以支持其他平台。
• 是否经过 MCP 认证？
  此项目旨在尽可能遵循 MCP 规范，以实现与 LLM 代理的最大兼容性。

🧠 启发来源

• Anthropic 的 模型上下文协议
• 现实中 LLM 驱动的自动化场景