Skip to main content
Glama
deenesjakoruzh
reeinharddd

snapmcp

by reeinharddd
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

Echte Terminalfarben, Shiki-hervorgehobener Code, visuelle Diffs, PDFs und GIFs – ein MCP-Server, 13 Tools, null schwere Abhängigkeiten. SSRF-Schutz standardmäßig aktiviert. Entwickelt für Agenten, die Dokumentation schreiben, nicht nur Browser steuern.

Schnellstart

Drei Schritte, unter zwei Minuten:

1. Installieren

npm install -g snapmcp
# or run without installing: npx -y snapmcp

2. Zu Claude Code hinzufügen (~/.claude/claude.json)

{
  "mcpServers": {
    "snapmcp": {
      "command": "npx",
      "args": ["-y", "snapmcp"],
      "env": {
        "SNAPMCP_DIR": "./captures",
        "SNAPMCP_THEME": "nord"
      }
    }
  }
}

3. Erfassen

Fragen Sie Ihren Agenten in natürlicher Sprache:

„Erfassen Sie einen Terminal-Screenshot von git log --oneline -5 und ein syntax-hervorgehobenes PNG von src/index.ts."

Der Agent ruft capture_terminal und capture_file auf – die Bilder landen in ./captures/ mit Ihrem echten Terminal-Theme und dem gewählten Syntax-Theme.

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/snapmcp

Related MCP server: @tscafejr/mcp

So sieht es aus

Echte Screenshots, generiert von snapmcp:

Capture

Vorschau

Terminal (echte erkannte Farben)

Code (Shiki-Syntax)

Diff (grün/rot)

Markdown-Render

Warum snapmcp statt Playwright MCP

Verschiedene Werkzeuge für verschiedene Aufgaben. Playwright MCP steuert einen Browser über token-effiziente Accessibility-Snapshots; snapmcp rendert pixelgetreue Bilder zum Lesen für Menschen. Wenn Ihr Agent klicken muss, verwenden Sie Playwright. Wenn er zeigen muss, verwenden Sie snapmcp.

Anwendungsfall

snapmcp

Playwright MCP

Terminal-Capture mit echten Farben

✅ erkennt Kitty-, Gnome-, Alacritty-, WezTerm-Themes automatisch

❌ keine Terminal-Unterstützung

Code → syntax-hervorgehobenes Bild

✅ Shiki, 50+ Sprachen, 27 Themes

❌ nicht sein Zweck

Git-Diff → visuelles Rot/Grün-Bild

✅ capture_diff

❌

URL → PDF-Dokument

✅ capture_pdf

❌

Animiertes GIF aus Captures

✅ capture_gif (zero-dep gifenc)

❌

Markdown → gestyltes Dokument

✅ capture_markdown, capture_to_document

❌

Browser-Seiten-Screenshot

✅ capture_browser (ganzseitig oder Viewport)

✅

Browser-Automatisierung (Klicken, Ausfüllen, Navigieren)

❌ nur Screenshots

✅ Accessibility-Tree-basiert, token-effizient – das richtige Werkzeug dafür

Die meisten Dokumentations-Pipelines kombinieren beide: Playwright MCP zum Interagieren, snapmcp zum Dokumentieren.

Tools

Tool

Beschreibung

capture_terminal

Terminalausgabe mit syntax-gefärbten Prompts (erkennt echtes Terminal-Theme automatisch)

capture_code

Syntax-hervorgehobener Code über Shiki (50+ Sprachen, 27 Themes)

capture_browser

Ganzseitige oder Viewport-Screenshots (verwendet System-Chrome-Profil, falls verfügbar)

capture_file

Datei → automatisch erkannte Sprache → hervorgehobener Screenshot

capture_markdown

Gerendertes Markdown als gestyltes Dokument

capture_html

Beliebiges HTML-Snippet als Bild gerendert

capture_diff

Git-Diffs mit grünen Ergänzungen / roten Löschungen

capture_pdf

URL → PDF-Dokument

capture_batch

Mehrere Elemente in einem Aufruf als Batch erfassen

capture_gif

Animiertes GIF aus mehreren Screenshots

capture_sequence

Nebeneinander animierte Sequenz

capture_to_document

Mehrabschnittiges Markdown-Dokument rendern

snapmcp-hint

Server-Fähigkeitshinweise für MCP-Clients

Anwendungsfälle

Automatisierte Dokumentation – ein Agent schreibt eine Setup-Anleitung und bettet echte Captures ein: die Terminalausgabe des Installationsbefehls (mit Ihrem tatsächlichen Theme), die Konfigurationsdatei syntax-hervorgehoben, das Diff der Migration. Ein Prompt, drei capture_*-Aufrufe, Bilder neben dem Markdown gespeichert.

Visuelles QA – nach einer UI-Änderung erfasst der Agent die betroffenen Seiten mit capture_browser, bündelt Vorher/Nachher mit capture_batch und erstellt einen animierten Vergleich mit capture_gif für die PR-Beschreibung.

Terminal-Anleitungen – CLI-Tutorials, bei denen die Screenshots dem entsprechen müssen, was die Leser sehen werden: capture_terminal reproduziert die echten Prompt-Farben statt eines generischen dunklen Rechtecks.

Sicherheit

SSRF-Schutz ist standardmäßig aktiviert – kein Opt-in erforderlich.

Funktion

Beschreibung

SSRF-Schutz

Standardmäßig aktiviert (deaktivieren mit SNAPMCP_SSRF_PROTECTION=false). Blockiert IP-Literale (v4 + v6), localhost-Varianten und DNS-Namen, die auf private Bereiche auflösen (127.0.0.0/8, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, fc00::/7, fe80::/10 usw.); jede Seitenanfrage (einschließlich Redirects) wird erneut geprüft

Datei-Allowlist

SNAPMCP_ALLOWED_PATHS standardmäßig auf Deny-All, wenn nicht gesetzt; nur explizit erlaubte Pfade können erfasst werden

Path Traversal

Verhindert ../-Escapes, Symlink-Traversal (über realpath) und Null-Byte-Injection

Eingabelimits

Terminal 1000 Zeilen; Code/Markdown/HTML 200KB; Diff 500KB; Dateilesevorgänge 5MB; max. GIF-Frames 60; max. GIF-Canvas 8192×8192

Audit-Log

Optionale strukturierte JSON-Logdatei mit Zeitstempel-Ereignissen

Chromium-Sandbox

Sandbox-Verfügbarkeit wird beim Start geprüft

Konfiguration

Umgebungsvariablen für den MCP-Server:

Variable

Standardwert

Beschreibung

SNAPMCP_DIR

./captures

Ausgabeverzeichnis für Captures

SNAPMCP_THEME

automatisch erkannt

Syntax-Thema (27 integrierte Shiki-Themen + automatisch erkanntes Terminal)

SNAPMCP_FORMAT

png

Ausgabeformat (png, jpeg)

SNAPMCP_QUALITY

90

JPEG-Qualität (1-100)

SNAPMCP_PADDING

32

Innenabstand des Inhalts in Pixeln

SNAPMCP_SHADOW

none

Schatten (none, soft, medium, strong; Aliase sm/md/lg)

SNAPMCP_WINDOW_CHROME

false

Titelleistenrahmen im macOS-Stil

SNAPMCP_BORDER_RADIUS

0

Eckenradius des Fensters

SNAPMCP_BADGE

false

Fußzeilen-Badge

SNAPMCP_LOG_FILE

—

Pfad der Audit-Log-Datei

SNAPMCP_CHROME_EXECUTABLE

—

Pfad zur Chrome/Chromium-Binärdatei

SNAPMCP_CHROME_CHANNEL

—

Chrome-Kanal (stable, beta, dev, canary)

SNAPMCP_CHROME_PROFILE

—

Name des Chrome-Profilverzeichnisses

SNAPMCP_ALLOWED_PATHS

(deny-all)

Durch Kommas oder Semikolons getrennte zulässige Dateipfade für capture_file

27 integrierte Shiki-Themen: 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

CLI

SnapMCP bietet über den MCP-Server hinaus eine vollständige CLI:

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 setup

Dokumentation

Seite

Inhalt

Erste Schritte

Installation, Schnellstart, MCP-Client-Einrichtung

Tools-Referenz

Alle 13 Tools mit Parametern und Beispielen

Konfiguration

Alle SNAPMCP_*-Umgebungsvariablen, Themes und Standardwerte

CLI-Referenz

Befehle: Init, doctor, test

Anleitungen

Terminal-Capture, Browser-Capture, GIF-Animation

ARCHITECTURE.md

Modulübersicht, Datenfluss, Sicherheitsarchitektur

CONTRIBUTING.md

Entwicklungsabläufe, Testrichtlinien, PR-Checkliste

Entwicklung

git clone https://github.com/reeinharddd/snapmcp
cd snapmcp
bun install
bun run build    # tsc → dist/
bun test         # 317 tests

Anforderungen: Node.js ≥ 20 oder Bun ≥ 1.2. CI läuft auf ubuntu / macOS / windows über GitHub Actions.

Lizenz

MIT — siehe LICENSE.

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
2wRelease cycle
5Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • ws-mcp

    rm-rf-prod
    A
    license
    A
    quality
    A
    maintenance
    A self-hosted MCP server that fetches live documentation and performs code audits using real-time authoritative references to prevent AI hallucinations. It provides tools for searching documentation across 330+ libraries and scanning local source code for security, performance, and accessibility issues.
    14
    601
    5
    Elastic 2.0

  • aifmt

    ericchansen
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that fixes, validates, and generates visual text content for AI coding assistants.
    MIT

View all related MCP servers

Related MCP Connectors

  • doc2mcp

    MCP server for doc2mcp documentation, generated by doc2mcp.

  • neverinfamous-memory-journal-mcp

    A MCP server built for developers enabling Git based project management with project and personal…

  • mcp

    Augments MCP Server - A comprehensive framework documentation provider for Claude Code

View all MCP Connectors

Latest Blog Posts

MCP directory API

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