AI导哈

截图微服务

一个轻量级的、兼容MCP的截图微服务，用于通过HTTP调用捕获全屏、区域或特定窗口的截图。

  • by margusmartsepp
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 margusmartsepp/mcp-screenshot-server

使用说明

🖼️ MCP屏幕截图服务器

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

🔧 特性

  • 📸 捕获全屏屏幕截图
  • 🪟 按标题捕获特定窗口
  • 🔲 捕获自定义区域 [x, y, width, height]
  • 🧠 符合MCP的REST API
  • 🖼️ 以PNG或base64格式返回图像
  • 🚀 使用FastAPI构建，可用于生产或LLM使用

🧠 用例

  • 使用以下方式与LLM集成 模型上下文协议（MCP）
  • QA测试自动化管道
  • 监控和远程捕获工具
  • 用于代理的可视化日志记录/调试工具

📦 安装

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+
  • 快速 API
  • mss 或 pyautogui 截图
  • pillow 用于图像处理
  • pygetwindow 用于窗口匹配（可选）

📄 许可证

MIT许可证。
无论是商业还是个人，都可以自由使用、分叉和集成。
看 许可证 了解详情。

📬 贡献

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

🙋 常见问题解答

  • 它在Linux/macOS上工作吗？
    还没有。此版本以Windows为中心，但欢迎您对其进行扩展。

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

🧠 灵感


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”)?

相关 MCP