screenshot-mcp

一个 MCP 服务器，用于捕获全屏截图并以内联（base64）或保存为文件的形式返回。支持 macOS、原生 Linux（X11 和 Wayland）、原生 Windows 以及 WSL2。

工具

list_monitors

列出所有已连接的显示器及其索引、分辨率和主显示器状态。请先调用此工具以查找显示器索引。

take_screenshot

捕获单个显示器的截图。

提示： 超高分辨率显示器（4K、5K）会产生巨大的 base64 数据块。如果遇到上下文限制，请切换到 return="path" 并使用 Read 工具查看文件。

Related MCP server: GetScreen MCP Server

安装

git clone https://github.com/you/screenshot-mcp
cd screenshot-mcp
npm install
npm run build

平台要求

在 Claude Code 中配置

claude mcp add screenshot node /absolute/path/to/screenshot-mcp/dist/index.js

在 Claude Desktop 中配置

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "screenshot": {
      "command": "node",
      "args": ["/absolute/path/to/screenshot-mcp/dist/index.js"]
    }
  }
}

WSL2 的工作原理

WSL2 无法直接访问 Windows 显示器。此服务器会检测 WSL（通过 /proc/version 或 WSL_DISTRO_NAME），并调用 Windows 端的 powershell.exe，使用 System.Windows.Forms.Screen 和 System.Drawing 运行捕获脚本。PNG 文件通过 \wsl.localhost... UNC 路径写入 Linux /tmp 文件系统，然后被读取。