使用说明
mcp屏幕截图
MCP（模型上下文协议）服务器，用于截图、列出窗口和列出监视器。用Rust构建。
特性
- 全屏截图
- 基于区域的屏幕截图
- 窗口特定截图
- 带有位置、大小和状态的窗口列表
- 显示分辨率和布局信息的监控列表
- 通过MCP图像内容返回的截图为base64编码的PNG
- 可选文件保存
后端
| 后端 | 平台 | 窗口支持 |
|---|---|---|
| 桌面 （默认） | X11、Wayland、macOS、Windows | 是 |
| 密钥管理服务 | 嵌入式Linux（DRM/KMS，无显示服务器） | 否 |
启动时自动检测后端：
MCP_SCREENSHOT_BACKEND一个被推翻了(desktop或kms)DISPLAY/WAYLAND_DISPLAY当前→ 桌面/dev/dri/card*具有主动输出→ KMS- 回退到桌面
工具
| 工具 | 描述 | 桌面 | kms |
|---|---|---|---|
take_screenshot |
全屏截图 | 是 | 是 |
take_screenshot_region |
区域截图 | 是 | 是 |
take_screenshot_window |
窗口截图 | 是 | - |
list_windows |
列出所有窗口 | 是 | - |
list_monitors |
列出所有监视器 | 是 | 是 |
在KMS后端，窗口工具完全从MCP工具列表中删除——客户端永远看不到它们。
参数
| 工具 | 参数 |
|---|---|
take_screenshot |
monitor_id?: u32, save_path?: string |
take_screenshot_region |
x: i32, y: i32, width: u32, height: u32, monitor_id?: u32, save_path?: string |
take_screenshot_window |
window_id: u32, save_path?: string |
list_windows |
（无） |
list_monitors |
（无） |
安装
# Default (desktop backend, stdio transport)
cargo install mcp-screenshot
# HTTP + KMS (headless server)
cargo install mcp-screenshot --no-default-features --features http,kms
看 构建.md 从源头上进行建设。
运输
默认情况下，服务器使用 标准 运输。随着 http 功能已启用，您可以切换到 HTTP 流式传输 传输——非常适合运行KMS后端的无头服务器。
HTTP传输
通过CLI标志或环境变量在HTTP模式下启动：
# CLI flag (default port 8080)
mcp-screenshot --http
# Custom port
mcp-screenshot --http --port 3000
# Environment variables
MCP_SCREENSHOT_TRANSPORT=http MCP_SCREENSHOT_PORT=3000 mcp-screenshot
服务器正在监听 http://0.0.0.0:<port>/mcp.
用法
克劳德桌面（stdio）
增添 claude_desktop_config.json:
{
"mcpServers": {
"screenshot": {
"command": "/path/to/mcp-screenshot"
}
}
}
克劳德桌面（HTTP）
启动服务器，然后添加到 claude_desktop_config.json:
{
"mcpServers": {
"screenshot": {
"url": "http://localhost:8080/mcp"
}
}
}
克劳德代码（stdio）
cargo install mcp-screenshot
claude mcp add screenshot mcp-screenshot
克劳德代码（HTTP）
cargo install mcp-screenshot --no-default-features --features http
claude mcp add --transport http screenshot http://localhost:8080/mcp
技术栈
- rmcp 0.13-官方Rust MCP SDK（stdio和HTTP流传输）
- 接入协议 0.8-跨平台屏幕截图
- 数字版权管理 0.14-DRM/KMS绑定（KMS后端）
- 图像 0.25-图像处理
- 东京 -异步运行时
许可证
麻省理工学院
