Настоящие цвета терминала, код с подсветкой Shiki, визуальные диффы, PDF и GIF — один MCP-сервер, 13 инструментов, ноль тяжёлых зависимостей. Защита от SSRF включена по умолчанию. Создан для агентов, которые пишут документацию, а не просто управляют браузерами.
Три шага — меньше двух минут:
1. Установите
npm install -g snapmcp
# or run without installing: npx -y snapmcp2. Добавьте в Claude Code (~/.claude/claude.json)
{
"mcpServers": {
"snapmcp": {
"command": "npx",
"args": ["-y", "snapmcp"],
"env": {
"SNAPMCP_DIR": "./captures",
"SNAPMCP_THEME": "nord"
}
}
}
}3. Захват
Попросите агента естественным языком:
«Сделай снимок терминала с выводом
git log --oneline -5и PNG с подсветкой синтаксиса дляsrc/index.ts».
Агент вызовет capture_terminal и capture_file — изображения сохранятся в ./captures/ с вашей реальной темой терминала и выбранной темой подсветки синтаксиса.
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
Реальные скриншоты, созданные snapmcp:
Снимок | Предпросмотр |
Терминал (реальные распознанные цвета) | |
Код (подсветка Shiki) | |
Дифф (зелёный/красный) | |
Рендер Markdown |
Разные инструменты — для разных задач. Playwright MCP управляет браузером через экономные по токенам accessibility-снимки; snapmcp создаёт попиксельно точные изображения для чтения человеком. Если вашему агенту нужно кликать — используйте Playwright. Если нужно показывать — используйте snapmcp.
Задача | snapmcp | Playwright MCP |
Захват терминала с реальными цветами | ✅ автоматически определяет темы Kitty, Gnome, Alacritty, WezTerm | ❌ нет поддержки терминала |
Код → изображение xостингом подсветки синтаксиса | ✅ Shiki, 50+ языков, 27 тем | ❌ не его задача |
Git-дифф → визуальное красно-зелёное изображение | ✅ | ❌ |
URL → PDF-документ | ✅ | ❌ |
Анимированный GIF из снимков | ✅ | ❌ |
Markdown → стилизованный документ | ✅ | ❌ |
Скриншот страницы браузера | ✅ | ✅ |
Автоматизация браузера (клик, заполнение, навигация) | ❌ только скриншоты | ✅ на основе accessibility-дерева, экономно по токенам — правильный инструмент для этого |
Большинство конвейеров документации используют их вместе: Playwright MCP — чтобы взаимодействовать, snapmcp — чтобы документировать.
Инструмент | Описание |
| Вывод терминала с синтаксически подсвеченными приглашениями (автоопределяет реальную тему) |
| Код с подсветкой синтаксиса через Shiki (50+ языков, 27 тем) |
| Скриншот полной страницы или области просмотра (использует системный профиль Chrome при наличии) |
| Файл → автоопределение языка → подсвеченный скриншот |
| Рендер Markdown в виде стилизованного документа |
| Произвольный HTML-фрагмент, отрендеренный в изображение |
| Git-диффы с зелёными добавлениями / красными удалениями |
| URL → PDF-документ |
| Пакетный захват нескольких элементов за один вызов |
| Анимированный GIF из нескольких скриншотов |
| Анимированная последовательность для сравнения (side-by-side) |
| Рендер многораздельного документа из Markdown |
| Подсказки о возможностях сервера для MCP-клиентов |
Автоматическая документация — агент пишет руководство по установке и встраивает реальные снимки: вывод терминала команды установки (с вашей настоящей темой), подсвеченный конфигурационный файл, дифф миграции. Один запрос — три вызова capture_*, изображения сохраняются рядом с markdown-файлом.
Визуальный QA — после изменения интерфейса агент снимает затронутые страницы с помощью capture_browser, объединяет «до/после» через capture_batch и собирает анимированное сравнение через capture_gif для описания PR.
Руководства по терминалу — обучающие материалы по CLI, где скриншоты должны соответствовать тому, что увидит читатель: capture_terminal воспроизводит настоящие цвета приглашения вместо обычного тёмного прямоугольника.
Защита от SSRF включена по умолчанию — не нужно явно включать.
Функция | Описание |
Защита SSRF | Включена по умолчанию (отключить — |
Список разрешённых путей |
|
Защита пути | Предотвращает выход через |
Лимиты ввода | Терминал: 1000 строк; код/Markdown/HTML: 200 КБ; дифф: 500 КБ; чтение файлов: 5 МБ; максимум кадров GIF: 60; максимальный холст GIF: 8192×8192 |
Журнал аудита | Необязательный структурированный JSON-журнал с метками времени событий |
Песочница Chromium | Доступность песочницы проверяется при запуске |
Переменные окружения для MCP-сервера:
Переменная | По умолчанию | Описание |
|
| Каталог вывода для снимков |
| автоопределение | Синтаксическая тема (27 встроенных тем + автоопределение терминала) |
|
| Формат вывода ( |
|
| Качество JPEG (1-100) |
|
| Отступ содержимого в пикселях |
|
| Тень ( |
|
| Рамка заголовка в стиле macOS |
|
| Радиус скругления углов окна |
|
| Значок в нижнем колонтитуле |
| — | Путь к файлу журнала аудита |
| — | Путь к исполняемому файлу Chrome/Chromium |
| — | Канал Chrome ( |
| — | Имя каталога профиля Chrome |
| (запрещено всё) | Разрешённые пути к файлам через запятую или точку с запятой для |
27 встроенных тем Shiki: 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 поставляется с полноценным CLI помимо 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 setupСтраница | Содержание |
Установка, быстрый старт, настройка MCP-клиента | |
Все 13 инструментов с параметрами и примерами | |
Все переменные окружения SNAPMCP_*, темы, значения по умолчанию | |
Команды init, doctor, test | |
Захват терминала, захват браузера, GIF-анимация | |
Карта модулей, поток данных, архитектура безопасности | |
Процесс разработки, рекомендации по тестированию, чек-лист PR |
git clone https://github.com/reeinharddd/snapmcp
cd snapmcp
bun install
bun run build # tsc → dist/
bun test # 317 testsТребования: Node.js ≥ 20 или Bun ≥ 1.2. CI запускается на ubuntu / macOS / windows через GitHub Actions.
MIT — см. 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