Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@snapmcp Capture a terminal screenshot of git log --oneline -5 and a syntax-highlighted PNG of src/index.ts."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Real terminal colors, Shiki-highlighted code, visual diffs, PDFs and GIFs — one MCP server, 13 tools, zero heavy dependencies. SSRF protection on by default. Built for agents that write documentation, not just drive browsers.
Three steps, under two minutes:
1. Install
npm install -g snapmcp
# or run without installing: npx -y snapmcp2. Add to Claude Code (~/.claude/claude.json)
{
"mcpServers": {
"snapmcp": {
"command": "npx",
"args": ["-y", "snapmcp"],
"env": {
"SNAPMCP_DIR": "./captures",
"SNAPMCP_THEME": "nord"
}
}
}
}3. Capture
Ask your agent in natural language:
"Capture a terminal screenshot of
git log --oneline -5and a syntax-highlighted PNG ofsrc/index.ts."
The agent calls capture_terminal and capture_file — images land in ./captures/ with your real terminal theme and the chosen syntax theme applied.
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
Real screenshots generated by snapmcp:
Capture | Preview |
Terminal (real detected colors) | |
Code (Shiki syntax) | |
Diff (green/red) | |
Markdown render |
Different tools for different jobs. Playwright MCP drives a browser through token-efficient accessibility snapshots; snapmcp renders pixel-faithful images for humans to read. If your agent needs to click, use Playwright. If it needs to show, use snapmcp.
Use case | snapmcp | Playwright MCP |
Terminal capture with real colors | ✅ auto-detects Kitty, Gnome, Alacritty, WezTerm themes | ❌ no terminal support |
Code → syntax-highlighted image | ✅ Shiki, 50+ languages, 27 themes | ❌ not its purpose |
Git diff → visual red/green image | ✅ | ❌ |
URL → PDF document | ✅ | ❌ |
Animated GIF from captures | ✅ | ❌ |
Markdown → styled document | ✅ | ❌ |
Browser page screenshot | ✅ | ✅ |
Browser automation (click, fill, navigate) | ❌ screenshots only | ✅ accessibility-tree driven, token-efficient — the right tool for this |
Most documentation pipelines pair them: Playwright MCP to interact, snapmcp to document.
Tool | Description |
| Terminal output with syntax-colored prompts (auto-detects real terminal theme) |
| Syntax-highlighted code via Shiki (50+ languages, 27 themes) |
| Full-page or viewport screenshots (uses system Chrome profile when available) |
| File → auto-detected language → highlighted screenshot |
| Rendered markdown as a styled document |
| Arbitrary HTML snippet rendered as image |
| Git diffs with green additions / red deletions |
| URL → PDF document |
| Batch capture multiple items in one call |
| Animated GIF from multiple screenshots |
| Side-by-side animated sequence |
| Multi-section markdown document render |
| Server capability hints for MCP clients |
Automated documentation — an agent writes a setup guide and embeds real captures: the terminal output of the install command (with your actual theme), the config file syntax-highlighted, the diff of the migration. One prompt, three capture_* calls, images saved next to the markdown.
Visual QA — after a UI change, the agent captures the affected pages with capture_browser, batches before/after with capture_batch, and assembles an animated comparison with capture_gif for the PR description.
Terminal guides — CLI tutorials where the screenshots must match what readers will see: capture_terminal reproduces the real prompt colors instead of a generic dark rectangle.
SSRF protection is on by default — no opt-in required.
Feature | Description |
SSRF Protection | On by default (disable with |
File Allowlist |
|
Path Traversal | Prevents |
Input Limits | Terminal 1000 lines; code/markdown/HTML 200KB; diff 500KB; file reads 5MB; max GIF frames 60; max GIF canvas 8192×8192 |
Audit Log | Optional structured JSON log file with timestamped events |
Chromium Sandbox | Sandbox availability checked at startup |
Environment variables for the MCP server:
Variable | Default | Description |
|
| Output directory for captures |
| auto-detected | Syntax theme (27 built-in themes + auto-detected terminal) |
|
| Output format ( |
|
| JPEG quality (1-100) |
|
| Content padding in pixels |
|
| Drop shadow ( |
|
| macOS-style title bar frame |
|
| Window corner radius |
|
| Footer badge |
| — | Audit log file path |
| — | Path to Chrome/Chromium binary |
| — | Chrome channel ( |
| — | Chrome profile directory name |
| (deny-all) | Comma- or semicolon-separated allowed file paths for |
27 built-in Shiki themes: 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 ships with a full CLI beyond the MCP server:
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 setupPage | Contents |
Installation, quick start, MCP client setup | |
All 13 tools with parameters and examples | |
All SNAPMCP_* env vars, themes, defaults | |
Init, doctor, test commands | |
Terminal capture, browser capture, GIF animation | |
Module map, data flow, security architecture | |
Dev workflow, testing guidelines, PR checklist |
git clone https://github.com/reeinharddd/snapmcp
cd snapmcp
bun install
bun run build # tsc → dist/
bun test # 317 testsRequirements: Node.js ≥ 20 or Bun ≥ 1.2. CI runs on ubuntu / macOS / windows via GitHub Actions.
MIT — see 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