🚀 🖼️ 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 驱动的自动化场景