🖼️ MCP 截图服务器

一个轻量级的、兼容 MCP 的截图微服务，使用 FastAPI 构建，专为 Windows 设计。 它允许 AI 代理和自动化工具通过简单的 HTTP 调用来捕获全屏、基于区域或特定窗口的截图。

---

🔧 功能

• 📸 捕获全屏截图
• 🪟 通过标题捕获特定窗口
• 🔲 捕获自定义区域 [x, y, width, height]
• 🧠 兼容 MCP 的 REST API
• 🖼️ 以 PNG 或 base64 格式返回图像
• 🚀 使用 FastAPI 构建，为生产环境或 LLM 使用做好准备

---

🧠 使用场景

• 使用 模型上下文协议 (MCP) 与 LLM 集成
• QA 测试自动化流水线
• 监控和远程捕获工具
• 代理的视觉日志/调试工具

---

📦 安装

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 body:

{
  "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 许可证。 随意使用、fork 和集成 — 商业或个人用途均可。 有关详细信息，请参阅 LICENSE。

---

📬 贡献

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

---

🙋 常见问题解答

• 它可以在 Linux/macOS 上运行吗？ 目前还不行。此版本专注于 Windows，但欢迎您扩展它。

• 它是否通过 MCP 认证？ 本项目旨在尽可能遵循 MCP 规范，以最大限度地与 LLM 代理兼容。

---

🧠 灵感来源

• Anthropic 的 模型上下文协议
• 由 LLM 和 Python 驱动的真实世界自动化用例

---