MCP de captura de pantalla universal

Un servidor MCP (Model Context Protocol) que proporciona a los asistentes de IA capacidades de captura de pantalla, tanto de páginas web mediante Puppeteer como capturas de pantalla del sistema multiplataforma utilizando herramientas nativas del SO.

Características

• Capturas de pantalla de páginas web — Capture cualquier URL pública utilizando un navegador Chromium sin interfaz gráfica (headless).

• Capturas de pantalla del sistema multiplataforma — Captura de pantalla completa, ventana o región utilizando herramientas nativas del SO (macOS screencapture, Linux maim/scrot/gnome-screenshot/etc., Windows PowerShell+.NET).

• Diseño centrado en la seguridad — Prevención de SSRF, protección contra recorrido de rutas, defensa contra rebinding de DNS, prevención de inyección de comandos y limitación de DoS.

• Nativo de MCP — Se integra directamente con Claude Desktop, Cursor y cualquier cliente compatible con MCP.

Related MCP server: Webpage Screenshot MCP Server

Requisitos

• Node.js >= 18.0.0

• Chromium se descarga automáticamente mediante Puppeteer en la primera ejecución.

Requisitos específicos de la plataforma para take_system_screenshot

Ejemplos de instalación en Linux

# Ubuntu/Debian (recommended)
sudo apt install maim xdotool

# Fedora
sudo dnf install maim xdotool

# Arch Linux
sudo pacman -S maim xdotool

# Wayland (Sway, etc.)
sudo apt install grim

Después de instalar, puede verificar su configuración con:

npx universal-screenshot-mcp --doctor

Esto analiza el host e imprime comandos de instalación que puede copiar y pegar para cualquier herramienta faltante, adaptados a su distribución detectada.

Inicio rápido

Instalar desde npm

npm install -g universal-screenshot-mcp

O ejecútelo directamente con npx:

npx universal-screenshot-mcp

Instalar desde el código fuente

git clone https://github.com/sethbang/mcp-screenshot-server.git
cd mcp-screenshot-server
npm install
npm run build

Configure su cliente MCP

Añada el servidor a la configuración de su cliente MCP. Para Claude Desktop, edite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "screenshot-server": {
      "command": "npx",
      "args": ["-y", "universal-screenshot-mcp"]
    }
  }
}

O si se instaló desde el código fuente:

{
  "mcpServers": {
    "screenshot-server": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-screenshot-server/build/index.js"]
    }
  }
}

Para Claude Code, registre el servidor con el comando claude mcp add:

# Project scope (current directory only)
claude mcp add screenshot-server -- npx -y universal-screenshot-mcp

# User scope (available across all projects)
claude mcp add --scope user screenshot-server -- npx -y universal-screenshot-mcp

O si se instaló desde el código fuente:

claude mcp add screenshot-server -- node /absolute/path/to/mcp-screenshot-server/build/index.js

Verifique que el servidor se registró con claude mcp list, o compruebe el estado en vivo desde una sesión con /mcp.

Para Cursor u otros clientes MCP, consulte su documentación para la configuración equivalente.

Herramientas

El servidor expone dos herramientas MCP:

take_screenshot

Captura una página web (o un elemento específico) a través de un navegador Puppeteer sin interfaz gráfica.

Ejemplo de prompt:

Toma una captura de pantalla de https://example.com a 1920x1080

take_system_screenshot

Captura el escritorio, una ventana de aplicación específica o una región de la pantalla utilizando herramientas nativas del SO. Funciona en macOS, Linux y Windows.

Soporte de funciones multiplataforma

Ejemplo de prompt:

Toma una captura de pantalla del sistema de la ventana de Safari

Configuración

Variables de entorno

Directorios de salida

Las capturas de pantalla se guardan en ~/Documents/screenshots de forma predeterminada (configurable mediante SCREENSHOT_OUTPUT_DIR). Las rutas de salida personalizadas deben resolverse en uno de estos directorios permitidos:

Seguridad

Este servidor implementa múltiples capas de refuerzo de seguridad:

Para obtener todos los detalles, consulte docs/security.md.

Desarrollo

Scripts

Estructura del proyecto

src/
├── index.ts                 # Entry point — stdio transport
├── server.ts                # MCP server factory
├── config/
│   ├── index.ts             # Static constants (limits, allowed dirs)
│   └── runtime.ts           # Singleton semaphore, default directory
├── tools/
│   ├── take-screenshot.ts   # Web page capture tool
│   └── take-system-screenshot.ts  # macOS system capture tool
├── types/
│   └── index.ts             # Shared TypeScript interfaces
├── utils/
│   ├── helpers.ts           # Response builders, file utilities
│   ├── screenshot-provider.ts # Cross-platform provider interface + factory
│   ├── macos-provider.ts    # macOS: screencapture wrapper
│   ├── linux-provider.ts    # Linux: maim/scrot/gnome-screenshot/etc.
│   ├── windows-provider.ts  # Windows: PowerShell + .NET System.Drawing
│   ├── macos.ts             # Window ID lookup via CoreGraphics
│   └── semaphore.ts         # Async concurrency limiter
└── validators/
    ├── path.ts              # Output path validation (SEC-004)
    └── url.ts               # URL/SSRF validation (SEC-001)

Pruebas

Las pruebas utilizan Vitest en tres niveles:

• Unitarias (npm test) — Inyección de dependencias completa, sin E/S real. Bucle de retroalimentación rápido.

• Integración (npm run test:integration) — Resolución de DNS real, sistema de archivos real con directorios temporales, Puppeteer real contra un servidor HTTP local.

• E2E (npm run test:e2e) — Herramientas de captura de pantalla nativas reales. Las pruebas de macOS se ejecutan de forma nativa; las pruebas de Linux se ejecutan en Docker mediante npm run test:linux.

npm test                 # Unit tests (~300ms)
npm run test:linux       # Linux provider tests in Docker
npm run test:all         # Everything

Depuración con el Inspector MCP

npm run inspector

Esto inicia el Inspector MCP conectado a su servidor compilado, lo que le permite invocar herramientas de forma interactiva.

Licencia

Apache-2.0 — Copyright 2026 Seth Bang