snapWONDERS MCP (local) — MCP-сервер для Claude Code
Локальный MCP-сервер: агент читает файл с вашего диска, отправляет его на обработку и складывает результат обратно. Пригодится, когда картинка или видео лежат на рабочем столе, а не в облаке.
claude mcp add mcp-local -e SNAPWONDERS_API_KEY=<SNAPWONDERS_API_KEY> -- uvx snapwonders-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, если такой путь окажется в вызове.
Какие задачи решает
- найти скрытые данные в присланной фотографии
- спрятать рабочий файл внутри безобидной картинки
- достать содержимое из видео, где что-то зашито
- перегнать ролик или снимок в другой формат без ручных конвертеров
- проверить, какие метаданные утекают вместе с публикуемым изображением
Примеры запросов агенту
- Проанализируй
~/Downloads/photo.jpg: оценка, метаданные, есть ли скрытое содержимое - Спрячь
notes.txtвнутриcover.pngс паролем из файлаpass.txtи сохрани результат рядом - Переконвертируй
clip.movв mp4 и скажи, куда записался файл
Как установить snapWONDERS MCP (local)
Командой платформы
claude mcp add mcp-local -e SNAPWONDERS_API_KEY=<SNAPWONDERS_API_KEY> -- uvx snapwonders-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from snapwonders-mcp <команда>
Командой платформы
codex mcp add snapwonders-mcp-local --env SNAPWONDERS_API_KEY=<SNAPWONDERS_API_KEY> -- uvx snapwonders-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from snapwonders-mcp <команда>
Файл настроек
{
"mcpServers": {
"snapwonders-mcp-local": {
"command": "uvx",
"args": [
"snapwonders-mcp"
],
"env": {
"SNAPWONDERS_API_KEY": "<SNAPWONDERS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from snapwonders-mcp <команда>
Файл настроек
{
"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 mcp add -e SNAPWONDERS_API_KEY=<SNAPWONDERS_API_KEY> snapwonders-mcp-local uvx snapwonders-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from snapwonders-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о snapWONDERS MCP (local)
Как установить snapWONDERS MCP (local) в Claude Code?
Одной командой: claude mcp add mcp-local -e SNAPWONDERS_API_KEY=<SNAPWONDERS_API_KEY> -- uvx snapwonders-mcp. Второй вариант — с явным stdio-транспортом и другим именем сервера: claude mcp add --env SNAPWONDERS_API_KEY=<SNAPWONDERS_API_KEY> --transport stdio snapwonders-mcp-local -- uvx snapwonders-mcp.
Что делает snapWONDERS MCP (local)?
Даёт ассистенту четыре инструмента для работы с локальными файлами: анализ, сокрытие, извлечение скрытого и конвертация. Файл читается на вашем диске и уходит в API snapWONDERS, результат записывается обратно на диск.
Чем локальный сервер отличается от удалённого https://snapwonders.com/mcp?
Удалённый ничего не ставит и годится для оркестрации сессий и заданий. Локальный умеет видеть ваши файлы — потому что запускается там, где они лежат, и сам их загружает.
