Mac-Screenshot-MCP

Mac-Screenshot-MCP (Model Context Protocol) 服务，封装 screencapture 命令提供全屏截图功能。

在 MCP Client 中配置

在你的 MCP 配置文件中添加：

{
  "mcpServers": {
    "Mac-Screenshot-MCP": {
      "command": "npx",
      "args": ["-y", "mac-screenshot-mcp"]
    }
  }
}

可用的 Tools

capture_screen - 全屏截图

捕获整个屏幕的画面并保存为 PNG 文件。

参数：

参数名	类型	默认值	说明
outputPath	string	~/Desktop/Screenshots/	截图保存目录（可选）
includeCursor	boolean	false	是否在截图中包含鼠标光标
showPreview	boolean	false	截图后是否显示预览窗口

示例请求：

{
  "tool": "capture_screen",
  "arguments": {
    "outputPath": "/Users/hamm/Pictures/Screenshots",
    "includeCursor": true
  }
}

示例响应：

{
  "success": true,
  "screenshotType": "fullscreen",
  "filePath": "/Users/hamm/Desktop/Screenshots/20260311143025.png",
  "fileName": "20260311143025.png",
  "captureTime": "2026-03-11T14:30:25.000Z",
  "options": {
    "includeCursor": true,
    "showPreview": false
  }
}

文件命名

截图文件使用年月日时分秒格式命名：YYYYMMDDHHmmss.png

示例：20260311143025.png

权限说明

首次使用时，macOS 会提示授予屏幕录制权限。如果未自动弹出，请手动在：

系统设置 → 隐私与安全性 → 屏幕录制

中授予终端或你的 MCP Client 屏幕录制权限。

License

MIT