🖼️ MCP Screenshot Server

🖼️ MCP 截图服务

一款基于 FastAPI 构建的轻量级、兼容 MCP 的 Windows 截图微服务。
AI Agent 和自动化工具可以通过简单的 HTTP 调用，截取全屏、指定区域或特定窗口的屏幕截图。

---

🔧 功能

• 📸 截取全屏截图
• 🪟 按标题截取特定窗口
• 🔲 截取自定义区域 [x, y, width, height]
• 🧠 符合 MCP 规范的 REST API
• 🖼️ 以 PNG 或 base64 格式返回图像
• 🚀 基于 FastAPI 构建，可用于生产环境或大模型

---

🧠 使用场景

• 使用 Model Context Protocol (MCP) 与大模型集成
• QA 测试自动化流水线
• 监控和远程截图工具
• 用于 Agent 的可视化日志记录/调试工具

---

📦 安装

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

---

🔌 API 用法

POST /screenshot

请求 JSON 正文：

{
  "region": [0, 0, 1280, 720],        // optional
  "window_title": "Untitled - Notepad", // optional
  "base64": true                      // optional (default: false)
}

响应（base64 模式）：

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

---

🛠️ 技术栈

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

---

📄 许可证

MIT License。
欢迎使用、分叉和集成，可用于商业或个人用途。
详情请参阅 LICENSE。

---

📬 参与贡献

欢迎提交拉取请求和问题！
欢迎提交 PR，以添加功能或提升跨平台兼容性（例如，支持 Mac/Linux）。

---

🙋 常见问题

• 它能在 Linux/macOS 上运行吗？
  目前还不能。此版本主要面向 Windows，但欢迎扩展它。

• 它通过 MCP 认证了吗？
  本项目旨在尽可能严格地遵循 MCP 规范，以最大限度地兼容大模型 Agent。

---

🧠 灵感来源

• Anthropic 的 Model Context Protocol
• 由大模型和 Python 驱动的真实自动化应用场景

---

Would you like me to tailor a specific section to emphasize AI agent use (e.g., “how to use with o1 or GPT-4o via plugin”)?