snip-mcp

화면 영역을 캡처하여 Claude Code 대화에 직접 추가할 수 있는 MCP 서버입니다. 단축키나 도구 호출을 사용하여 화면의 원하는 영역을 선택하면, 스크린샷이 즉시 컨텍스트 내 이미지로 제공됩니다.

주요 기능

• 단축키 캡처 -- Ctrl+Shift+클릭으로 언제 어디서나 캡처 오버레이 실행

• 도구 기반 캡처 -- Claude가 사용자를 대신하여 캡처 도구 호출 가능

• 다중 모니터 지원 -- DPI를 인식하여 모든 연결된 디스플레이에서 작동

• 영구 저장소 -- 캡처된 이미지는 디스크에 저장되며 서버 재시작 후에도 유지

• 자동 정리 -- 설정 가능한 제한을 통해 저장 공간 무한 증가 방지

• 토스트 알림 -- 캡처 성공 시 시각적 확인 알림 제공

Related MCP server: Shotik

요구 사항

• Windows 10 이상 (ctypes를 통한 Windows 전용 전역 마우스 후크 사용)

• Python 3.11+

설치

git clone https://github.com/Alparse/snip-mcp.git
cd snip-mcp
pip install -e .

또는 uv 사용 시:

git clone https://github.com/Alparse/snip-mcp.git
cd snip-mcp
uv pip install -e .

Claude Code 설정

Claude Code MCP 설정에 서버를 추가하세요.

pip으로 설치한 경우 (전역 또는 venv)

~/.claude/settings.json (전역) 또는 .claude/settings.json (프로젝트) 파일에 추가:

{
  "mcpServers": {
    "snip": {
      "command": "snip-mcp"
    }
  }
}

uv를 사용하는 경우 (격리 권장)

{
  "mcpServers": {
    "snip": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/snip-mcp", "snip-mcp"]
    }
  }
}

사용법

단축키 캡처

화면 어디에서나 Ctrl+Shift+왼쪽 클릭을 누르면 캡처 오버레이가 나타납니다:

1. 클릭하고 드래그하여 영역 선택

2. 마우스 버튼을 놓아 캡처

3. Escape 키를 눌러 취소

토스트 알림을 통해 캡처가 확인됩니다.

도구 기반 캡처

Claude에게 스크린샷을 찍어달라고 요청하면 snip_screen 도구를 호출하여 오버레이를 열어줍니다.

캡처 관리

Claude가 사용할 수 있는 MCP 도구는 다음과 같습니다:

설정

설정은 ~/.snip_mcp/config.json에 저장되며 첫 실행 시 자동으로 생성됩니다.

설정 예시:

{
  "modifier_keys": ["ctrl", "shift"],
  "save_directory": "C:/Users/you/.snip_mcp/snips",
  "overlay_alpha": 0.3,
  "selection_color": "#00ff00",
  "selection_width": 2,
  "max_snips": 50
}

문제 해결

"snip-mcp requires Windows" 이 서버는 Windows 전용 API(ctypes를 통한 전역 마우스 후크)를 사용합니다. macOS나 Linux에서는 실행할 수 없습니다.

"Failed to install mouse hook" 전역 마우스 후크는 관리자 권한이 필요할 수 있습니다. 터미널을 관리자 권한으로 실행해 보세요.

오버레이가 나타나지 않음 다른 애플리케이션이 Ctrl+Shift+Click을 가로채고 있지 않은지 확인하세요. 설정 파일의 modifier_keys를 확인하세요.

고해상도(High-DPI) 디스플레이에서 좌표가 어긋남 서버는 시작 시 SetProcessDPIAware()를 호출합니다. 여전히 좌표 문제가 발생하면 Windows 디스플레이 배율 설정을 확인하세요.

캡처 디렉토리 기본적으로 캡처본은 ~/.snip_mcp/snips/에 저장됩니다. config.json에서 변경할 수 있습니다.

라이선스

MIT -- 자세한 내용은 LICENSE를 참조하세요.