snip-mcp

Un servidor MCP que te permite capturar regiones de pantalla directamente en tus conversaciones de Claude Code. Selecciona cualquier área de tu pantalla usando una tecla de acceso rápido o una llamada a herramienta, y la captura de pantalla estará disponible inmediatamente como una imagen en el contexto.

Características

• Captura con tecla de acceso rápido -- Ctrl+Shift+Clic abre una superposición de recorte en cualquier lugar, en cualquier momento

• Captura activada por herramienta -- Claude puede invocar la herramienta de recorte en tu nombre

• Soporte para múltiples monitores -- funciona en todas las pantallas conectadas con reconocimiento de DPI

• Almacenamiento persistente -- los recortes se guardan en el disco y sobreviven a los reinicios del servidor

• Limpieza automática -- un límite configurable evita el crecimiento ilimitado del almacenamiento

• Notificaciones emergentes -- confirmación visual cuando se captura un recorte

Related MCP server: Shotik

Requisitos

• Windows 10 o posterior (utiliza ganchos de ratón globales específicos de Windows a través de ctypes)

• Python 3.11+

Instalación

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

O con uv:

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

Configuración de Claude Code

Añade el servidor a tus ajustes de MCP de Claude Code.

Si se instaló mediante pip (global o venv)

En ~/.claude/settings.json (global) o .claude/settings.json (proyecto):

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

Si usas uv (recomendado para aislamiento)

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

Uso

Captura con tecla de acceso rápido

Presiona Ctrl+Shift+Clic izquierdo en cualquier lugar de la pantalla para abrir la superposición de recorte:

1. Haz clic y arrastra para seleccionar una región

2. Suelta para capturar

3. Presiona Escape para cancelar

Una notificación emergente confirma la captura.

Captura activada por herramienta

Pídele a Claude que tome una captura de pantalla: invocará la herramienta snip_screen y abrirá la superposición por ti.

Gestión de recortes

Estas herramientas MCP están disponibles para Claude:

Configuración

La configuración se almacena en ~/.snip_mcp/config.json y se crea automáticamente en la primera ejecución.

Ejemplo de configuración:

{
  "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
}

Solución de problemas

"snip-mcp requiere Windows" Este servidor utiliza APIs específicas de Windows (ganchos de ratón globales a través de ctypes). No puede ejecutarse en macOS o Linux.

"Failed to install mouse hook" El gancho de ratón global puede requerir permisos elevados. Intenta ejecutar tu terminal como administrador.

La superposición no aparece Asegúrate de que ninguna otra aplicación esté interceptando Ctrl+Shift+Clic. Verifica modifier_keys en tu configuración.

Las coordenadas están desplazadas en pantallas de alta resolución (DPI) El servidor llama a SetProcessDPIAware() al inicio. Si sigues viendo problemas de desplazamiento, verifica la configuración de escala de pantalla de Windows.

Directorio de recortes Por defecto, los recortes se almacenan en ~/.snip_mcp/snips/. Puedes cambiar esto en config.json.

Licencia

MIT -- consulta LICENSE para más detalles.