screenshot-mcp

전체 모니터 스크린샷을 캡처하여 인라인(base64) 또는 저장된 파일로 반환하는 MCP 서버입니다. 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을 통해) powershell.exe를 호출하여 System.Windows.Forms.Screen 및 System.Drawing을 사용하는 캡처 스크립트를 실행합니다. PNG는 \wsl.localhost\... UNC 경로를 통해 Linux /tmp 파일 시스템에 기록된 후 다시 읽어옵니다.