screenshot_mcp_server

🚀 截图 MCP 服务器

这是一个具备截图功能的MCP服务器，能让AI工具捕获并处理屏幕内容，为AI分析用户屏幕画面提供支持。

🚀 快速开始

此MCP服务器可让AI工具捕获用户屏幕截图，便于AI助手查看和分析用户当前所见内容。服务器负责图像的捕获、压缩与传输，以适配AI处理的格式提供图像。

✨ 主要特性

• 可捕获全屏截图。
• 自动进行JPEG压缩，实现高效传输。
• 采用Base64编码图像数据，确保传输可靠。
• 支持stdio和SSE两种传输模式。
• 图像质量和优化选项可配置。
• 拥有简单命令行界面，方便测试。

📦 安装指南

从源代码安装

# 克隆仓库
git clone https://github.com/codingthefuturewithai/screenshot_mcp_server.git
cd screenshot_mcp_server

# 使用UV进行安装（推荐）
uv pip install -e .

# 或使用pip安装
pip install -e .

📚 详细文档

可用工具

take_screenshot

描述：捕获用户屏幕的截图并以JPEG格式返回。 参数：无 返回：

• JPEG格式的图像内容，Base64编码

使用方法

服务器可以通过两种方式使用：

命令行客户端

# 捕获截图并保存到文件中
screenshot_mcp_server-client output.jpg

编程式使用

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async with stdio_client(StdioServerParameters(command="screenshot_mcp_server-server")) as (read, write):
    async with ClientSession(read, write) as session:
        result = await session.call_tool("take_screenshot")
        # 处理截图数据...

要求

• Python 3.10或更高版本（但小于3.13）
• 依赖项：
  • mcp >= 1.0.0
  • pyautogui >= 0.9.54
  • Pillow >= 10.0.0
• 操作系统：Linux、macOS、Windows

配置

服务器支持两种传输模式：

• stdio（默认）：用于命令行使用
• SSE：用于基于Web的应用，默认运行在3001端口

要在SSE模式下运行：

screenshot_mcp_server-server-sse --port 3001

📄 许可证

本项目遵循MIT许可证。

👨‍💻 作者

Tim Kitchens (timkitch@codingthefuture.ai)