# snapWONDERS MCP (local)

Локальный MCP-сервер: агент читает файл с вашего диска, отправляет его на обработку и складывает результат обратно. Пригодится, когда картинка или видео лежат на рабочем столе, а не в облаке.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: snapWONDERS
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/snapWONDERS/snapWONDERS-MCP
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/snapwonders-mcp-local

## Что делает

Сервер работает на вашей машине: ассистент передаёт ему путь к файлу, тот читает байты локально и заливает их по HTTPS в API snapWONDERS. Обратно приходит не идентификатор задачи, а готовый файл на диске, и модель сообщает, куда он лёг. Через MCP доступны четыре инструмента: `analyse_file` разбирает изображение или видео (оценка A–F, метаданные, следы правок, скрытое содержимое, по желанию распознавание лиц и OCR), `hide_file` прячет файл внутри картинки или видео, `reveal_file` достаёт спрятанное, `convert_file` меняет формат. Вся цепочка «сессия → загрузка → задание → опрос → результат» уже собрана в Python, поэтому модель не держит состояние из пяти шагов.

Перед запуском нужен аккаунт snapWONDERS и ключ из профиля — бесплатный, но адрес почты должен быть подтверждён, иначе ключ отклоняется на любом запросе. Ключ передаётся через переменную окружения `SNAPWONDERS_API_KEY`, а не аргументом инструмента, так что в контекст модели он не попадает. С паролем иначе: `hide_file` и `reveal_file` принимают парольную фразу как аргумент вызова, она проходит через контекст и может остаться в логах клиента. Восстановить такую фразу нельзя, запасного пути нет. Для запуска хватает `uvx`, отдельная установка не обязательна.

Сервер отправит на обработку любой файл, до которого дотянется процесс, включая `~/.ssh/id_rsa`, если такой путь окажется в вызове.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `SNAPWONDERS_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mcp-local -e SNAPWONDERS_API_KEY=<SNAPWONDERS_API_KEY> -- uvx snapwonders-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from snapwonders-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add snapwonders-mcp-local --env SNAPWONDERS_API_KEY=<SNAPWONDERS_API_KEY> -- uvx snapwonders-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from snapwonders-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "snapwonders-mcp-local": {
            "command": "uvx",
            "args": [
                "snapwonders-mcp"
            ],
            "env": {
                "SNAPWONDERS_API_KEY": "<SNAPWONDERS_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from snapwonders-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "snapwonders-mcp-local": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "snapwonders-mcp"
            ],
            "env": {
                "SNAPWONDERS_API_KEY": "<SNAPWONDERS_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from snapwonders-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e SNAPWONDERS_API_KEY=<SNAPWONDERS_API_KEY> snapwonders-mcp-local uvx snapwonders-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from snapwonders-mcp <команда>

## Когда брать
- найти скрытые данные в присланной фотографии
- спрятать рабочий файл внутри безобидной картинки
- достать содержимое из видео, где что-то зашито
- перегнать ролик или снимок в другой формат без ручных конвертеров
- проверить, какие метаданные утекают вместе с публикуемым изображением

## Примеры запросов агенту
- Проанализируй `~/Downloads/photo.jpg`: оценка, метаданные, есть ли скрытое содержимое
- Спрячь `notes.txt` внутри `cover.png` с паролем из файла `pass.txt` и сохрани результат рядом
- Переконвертируй `clip.mov` в mp4 и скажи, куда записался файл

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 392262
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89609
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12110
- [Robin: AI-Powered Dark Web OSINT](https://affpapa.org/nevibecode/mcp/robin-ai-powered-dark-web-osint.md) — MCP-сервер · ★ 7718
- [jshookmcp](https://affpapa.org/nevibecode/mcp/jshookmcp.md) — MCP-сервер · ★ 2066

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md