屏幕截图 MCP Server

一个用于截取电脑屏幕的 Model Context Protocol (MCP) 服务器，支持 Windows 和 macOS，支持多显示器环境。

功能特性

• 🖥️ 跨平台支持：Windows 和 macOS
• 🖼️ 多显示器支持：可截取所有显示器或指定单个显示器
• 📋 显示器列表：查看当前连接的所有显示器信息
• 🔢 Base64 输出：返回 PNG 格式的 base64 编码图片

安装

npm install

构建

npm run build

使用

作为 MCP 服务器运行

npm run mcp

MCP 配置

{
  "mcpServers": {
    "screenshot": {
      "command": "npx",
      "args": ["-y", "@anthropic/screenshot-mcp"]
    }
  }
}

可用工具

1. capture_screenshot

截取屏幕截图。

参数： | 参数 | 类型 | 必填 | 描述 | |------|------|------|------| | monitor | integer | 否 | 指定要截取的显示器编号（从0开始）。不传则截取所有显示器合成的画面 | | outputPath | string | 否 | 截图保存路径。可以是完整文件路径或目录路径。不传则默认保存到桌面 |

返回：

• PNG 格式的 base64 编码图片
• 截取的显示器信息
• 保存的文件路径

示例：

// 截取所有显示器，保存到桌面（默认）
{}

// 截取第一个显示器，保存到桌面
{ "monitor": 0 }

// 截取第二个显示器，保存到桌面
{ "monitor": 1 }

// 截取所有显示器，保存到指定路径
{ "outputPath": "C:/screenshots/my_screenshot.png" }

// 截取指定显示器，保存到指定目录（自动生成文件名）
{ "monitor": 0, "outputPath": "C:/screenshots/" }

2. list_displays

列出所有可用的显示器。

参数： 无

返回：

• 显示器数量
• 每个显示器的编号、名称、分辨率

多显示器说明

在多显示器环境下：

1. 不指定 monitor 参数：截取所有显示器合成的完整画面（横向拼接）
2. 指定 monitor 参数：只截取指定编号的显示器

建议先使用 list_displays 工具查看当前有哪些显示器可用，再决定截取哪个。

平台特定说明

Windows

• 使用 Windows 原生 API 进行截图
• 完全支持多显示器

macOS

• 使用 macOS 原生 API 进行截图
• 完全支持多显示器
• 首次使用可能需要授予屏幕录制权限

依赖

• @modelcontextprotocol/sdk: MCP 协议 SDK
• screenshot-desktop: 跨平台截图库

License

ISC