Colores reales de terminal, código resaltado con Shiki, diffs visuales, PDFs y GIFs: un solo servidor MCP, 13 herramientas, cero dependencias pesadas. Protección SSRF activada por defecto. Diseñado para agentes que escriben documentación, no solo para manejar navegadores.
Tres pasos, en menos de dos minutos:
1. Instalar
npm install -g snapmcp
# or run without installing: npx -y snapmcp2. Añadir a Claude Code (~/.claude/claude.json)
{
"mcpServers": {
"snapmcp": {
"command": "npx",
"args": ["-y", "snapmcp"],
"env": {
"SNAPMCP_DIR": "./captures",
"SNAPMCP_THEME": "nord"
}
}
}
}3. Capturar
Pídele a tu agente en lenguaje natural:
"Captura una imagen de terminal de
git log --oneline -5y un PNG con resaltado de sintaxis desrc/index.ts."
El agente llama a capture_terminal y capture_file: las imágenes se guardan en ./captures/ con tu tema real de terminal y el tema de sintaxis elegido aplicado.
OpenCode (opencode.json):
{
"mcpServers": {
"snapmcp": {
"command": "npx",
"args": ["-y", "snapmcp"],
"env": {
"SNAPMCP_DIR": "./captures",
"SNAPMCP_FORMAT": "jpeg",
"SNAPMCP_QUALITY": "95"
}
}
}
}VS Code / Cline / Roo-Cline (settings.json → cline.mcpServers):
{
"mcpServers": {
"snapmcp": {
"command": "npx",
"args": ["-y", "snapmcp"],
"env": {
"SNAPMCP_DIR": "./captures",
"SNAPMCP_FORMAT": "jpeg"
}
}
}
}Docker:
docker run -i --rm \
-e SNAPMCP_DIR=/captures \
-e SNAPMCP_THEME=nord \
-v /path/to/output:/captures \
ghcr.io/reeinharddd/snapmcpRelated MCP server: @tscafejr/mcp
Capturas reales generadas por snapmcp:
Capture | Preview |
Terminal (colores reales detectados) | |
Código (sintaxis Shiki) | |
Diff (verde/rojo) | |
Render de Markdown |
Herramientas diferentes para trabajos diferentes. Playwright MCP maneja un navegador mediante capturas de accesibilidad eficientes en tokens; snapmcp renderiza imágenes fieles al píxel para que las lean los humanos. Si tu agente necesita hacer clic, usa Playwright. Si necesita mostrar, usa snapmcp.
Use case | snapmcp | Playwright MCP |
Captura de terminal con colores reales | ✅ auto-detecta temas de Kitty, Gnome, Alacritty, WezTerm | ❌ sin soporte de terminal |
Código → imagen con resaltado de sintaxis | ✅ Shiki, 50+ lenguajes, 27 temas | ❌ no es su propósito |
Diff de Git → imagen visual rojo/verde | ✅ | ❌ |
URL → documento PDF | ✅ | ❌ |
GIF animado a partir de capturas | ✅ | ❌ |
Markdown → documento con estilo | ✅ | ❌ |
Captura de página del navegador | ✅ | ✅ |
Automatización del navegador (clic, rellenar, navegar) | ❌ solo capturas | ✅ basado en árbol de accesibilidad, eficiente en tokens — la herramienta adecuada para esto |
La mayoría de los flujos de documentación los combinan: Playwright MCP para interactuar, snapmcp para documentar.
Tool | Description |
| Salida de terminal con prompts coloreados por sintaxis (auto-detecta el tema real de terminal) |
| Código con resaltado de sintaxis mediante Shiki (50+ lenguajes, 27 temas) |
| Capturas de página completa o viewport (usa el perfil de Chrome del sistema cuando está disponible) |
| Archivo → lenguaje auto-detectado → captura resaltada |
| Markdown renderizado como documento con estilo |
| Fragmento HTML arbitrario renderizado como imagen |
| Diffs de Git con adiciones en verde / eliminaciones en rojo |
| URL → documento PDF |
| Captura por lotes de múltiples elementos en una sola llamada |
| GIF animado a partir de múltiples capturas |
| Secuencia animada lado a lado |
| Render de documento markdown de varias secciones |
| Indicaciones de capacidades del servidor para clientes MCP |
Documentación automatizada: un agente escribe una guía de instalación e incrusta capturas reales: la salida de terminal del comando de instalación (con tu tema real), el archivo de configuración con resaltado de sintaxis, el diff de la migración. Una sola instrucción, tres llamadas a capture_*, imágenes guardadas junto al markdown.
QA visual: después de un cambio de interfaz, el agente captura las páginas afectadas con capture_browser, agrupa antes/después con capture_batch y crea una comparación animada con capture_gif para la descripción del PR.
Guías de terminal: tutoriales de CLI donde las capturas deben coincidir con lo que verán los lectores: capture_terminal reproduce los colores reales del prompt en lugar de un rectángulo oscuro genérico.
La protección SSRF está activada por defecto — no se requiere opt-in.
Feature | Description |
Protección SSRF | Activada por defecto (desactivar con |
Lista de archivos permitidos |
|
Path Traversal | Previene escapes |
Límites de entrada | Terminal 1000 líneas; código/markdown/HTML 200KB; diff 500KB; lecturas de archivo 5MB; máximo de fotogramas GIF 60; lienzo GIF máximo 8192×8192 |
Registro de auditoría | Archivo de registro JSON estructurado opcional con eventos con marca de tiempo |
Sandbox de Chromium | La disponibilidad del sandbox se comprueba al inicio |
Variables de entorno para el servidor MCP:
Variable | Default | Description |
|
| Directorio de salida para capturas |
| auto-detectado | Tema de sintaxis (27 temas integrados + terminal auto-detectado) |
|
| Formato de salida ( |
|
| Calidad JPEG (1-100) |
|
| Relleno de contenido en píxeles |
|
| Sombra proyectada ( |
|
| Marco de barra de título estilo macOS |
|
| Radio de esquina de la ventana |
|
| Insignia de pie de página |
| — | Ruta del archivo de registro de auditoría |
| — | Ruta al binario de Chrome/Chromium |
| — | Canal de Chrome ( |
| — | Nombre del directorio de perfil de Chrome |
| (denegar todo) | Rutas de archivo permitidas separadas por comas o puntos y coma para |
27 temas Shiki integrados: dracula, one-dark-pro, nord, tokyo-night, catppuccin-mocha, catppuccin-latte, ayu-dark, ayu-light, vitesse-dark, vitesse-light, min-dark, min-light, poimandres, rose-pine, rose-pine-moon, rose-pine-dawn, slack-dark, slack-ochin, snazzy-light, github-dark-dimmed, github-light, one-light, solarized-light, solarized-dark, material-theme, material-theme-lighter, material-theme-ocean
SnapMCP incluye una CLI completa además del servidor MCP:
snapmcp — Start the MCP server
snapmcp init — Interactive setup wizard (detects Chrome, terminal theme, output dir)
snapmcp doctor — Health check: 7 checks across Node, Chromium, paths, env
snapmcp test — Generate test captures (terminal + code) to verify the setupPágina | Contenido |
Instalación, inicio rápido, configuración del cliente MCP | |
Las 13 herramientas con parámetros y ejemplos | |
Todas las variables de entorno SNAPMCP_*, temas y valores predeterminados | |
Comandos init, doctor y test | |
Captura de terminal, captura de navegador, animación GIF | |
Mapa de módulos, flujo de datos, arquitectura de seguridad | |
Flujo de trabajo de desarrollo, pautas de pruebas, lista de verificación de PR |
git clone https://github.com/reeinharddd/snapmcp
cd snapmcp
bun install
bun run build # tsc → dist/
bun test # 317 testsRequisitos: Node.js ≥ 20 o Bun ≥ 1.2. El CI se ejecuta en ubuntu / macOS / windows mediante GitHub Actions.
MIT — consulte LICENSE.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for doc2mcp documentation, generated by doc2mcp.
A MCP server built for developers enabling Git based project management with project and personal…
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/reeinharddd/snapmcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server