ImageSorcery MCP
Локальный MCP-сервер для правки и разбора изображений: агент обрезает кадры, находит объекты и читает текст с фото
- 334 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент читает и записывает файлы изображений по указанным путям, поэтому исходники стоит держать в резервной копии
- При установке скачиваются модели и пакет clip из репозитория на GitHub
Установка
- Работает в
Ручная установка
pipx install imagesorcery-mcp && imagesorcery-mcp --post-installВторой шаг обязателен: он скачивает модели и ставит clip для инструмента find.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает и записывает файлы изображений по указанным путям, поэтому исходники стоит держать в резервной копии
- При установке скачиваются модели и пакет clip из репозитория на GitHub
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ImageSorcery MCP дает агенту набор операций над изображениями, которые выполняются на вашем компьютере. Картинки не уходят на сторонние серверы. Работа строится на OpenCV, моделях Ultralytics YOLO и EasyOCR. Для правки есть обрезка, масштабирование и поворот. Еще сервер размывает и заливает участки, накладывает одно изображение на другое и меняет цвета. Для разметки агент добавляет на картинку текст, фигуры и стрелки. Распознавание ищет объекты выбранной моделью или по текстовому описанию, а OCR достает текст с картинки. Отдельные инструменты читают метаданные файла и меняют настройки сервера. Операции агент сам соединяет в цепочки. Например, можно попросить найти кошку на фото и обрезать кадр так, чтобы кошка оказалась в центре, или разложить фотографии с животными по папкам. Готовый промпт для удаления фона ведет агента через детекцию и маски. Список установленных моделей отдает отдельный ресурс. По умолчанию сервер работает через stdio, режимы streamable-http и sse включаются отдельно.
Для кого. Для тех, кто обрабатывает фотографии и скриншоты через Claude Desktop, Cline и другие MCP-клиенты и не хочет отправлять файлы в облако.
Подходит, если
- Нужно разобрать папку фотографий и скопировать кадры с животными в отдельную папку
- Нужно обрезать, уменьшить или повернуть пачку изображений по описанию, без ручного редактора
- Нужно достать текст со скриншота или скана с помощью OCR на нужном языке
- Нужно закрасить или размыть участок на изображении, например лица или номера
- Нужно вырезать объект по текстовому описанию и убрать фон
Не подходит, если
- Нужно создавать картинки с нуля: ImageSorcery правит и анализирует готовые изображения
- Нужна сложная ретушь и цветокоррекция уровня графического редактора: инструменты работают с простыми операциями OpenCV
- Нет Python 3.10 или нельзя поставить системные библиотеки OpenCV, например в минимальном контейнере
- Нет места на диске и времени ждать загрузку моделей на первой установке
Пример запроса к агенту
Найди кошку на photo.jpg и обрежь кадр вдвое по высоте и ширине, чтобы кошка оказалась в центре. Используй imagesorcery.MCP
- Транспорт
- stdio, http, sse
- Авторизация
- не нужна
Ограничения
Нужны Python 3.10 или новее, pipx и системные библиотеки `ffmpeg`, `libsm6`, `libxext6` и `libgl1-mesa-glx`. Без шага донастройки после установки модели YOLO и CLIP не скачаются. Поиск по описанию без CLIP не работает.
В окружении, созданном через `uv venv`, и при запуске через uvx пакет clip может не установиться. Автор рекомендует pipx или обычный `python -m venv`.
Обращаться к файлам лучше по полному пути. Если нужна конкретная модель, ее и порог уверенности стоит назвать в запросе. Телеметрия выключена по умолчанию, она не собирает изображения, пути к файлам и IP-адреса.
Как отключить. Удалите блок imagesorcery-mcp из настроек MCP-клиента и при желании выполните `pipx uninstall imagesorcery-mcp`. Скачанные модели лежат в каталоге models рядом с пакетом, `config.toml` лежит там, где вы запускали установку.
Частые вопросы
Как поставить ImageSorcery MCP в Claude Desktop?
Выполните `pipx install imagesorcery-mcp` и `imagesorcery-mcp --post-install`, затем добавьте в файл настроек сервер с командой imagesorcery-mcp и transportType stdio. После перезапуска клиента инструменты появятся в списке. На Windows команда называется `imagesorcery-mcp.exe`.
Что делает команда `imagesorcery-mcp --post-install`?
Создает `config.toml`, готовит каталог models, скачивает модели yoloe-11l-seg и yoloe-11s-seg, в том числе варианты с суффиксом pf, и пытается поставить пакет clip и скачать модель CLIP для поиска по описанию. Эту команду можно запускать повторно, чтобы вернуть модели по умолчанию.
Как подключить другую модель обнаружения объектов?
Модели докачивает команда `download-yolo-models`: с флагом `--ultralytics` для моделей Ultralytics и с `--huggingface` для моделей Hugging Face. После загрузки проверьте описания в файле models/model_descriptions.json.
Отправляет ли ImageSorcery изображения в интернет?
Нет, изображения обрабатываются на вашем компьютере. Анонимная телеметрия включается только явным согласием и собирает названия использованных инструментов, версию, тип системы и ошибки.
Чем поиск по описанию отличается от обнаружения объектов?
Обнаружение ищет объекты теми классами, которые знает выбранная модель Ultralytics. Поиск по описанию получает текст вроде «собаки» и находит подходящие объекты через CLIP. Оба варианта могут вернуть маски в формате PNG или полигоны.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Adobe Photoshop: удаление фона, ретушь, экспорт для соцсетей и пакетные операции голосом
Удаленный MCP-сервер Recraft: агент рисует растровые и векторные изображения, редактирует область, убирает фон и увеличивает разрешение
MCP-сервер для Windows, который управляет установленным Photoshop: документы, слои и произвольные скрипты JSX
Официальный удаленный MCP-сервер Kling AI: агент делает видео и изображения по тексту и по картинке прямо в рабочем чате
Claude Video Vision
claude-video-vision
MCP-сервер и плагин Claude Code, которые дают агенту смотреть видео: кадры через ffmpeg и расшифровка звука через Gemini, локальный Whisper или OpenAI
MCP-сервер для генерации изображений и видео из агента: несколько моделей, большая библиотека промптов и параллельные задачи
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ImageSorcery MCP (эта запись) | нет | не нужна | 334 | |
| Скиллы PaddleOCR | нет | 91 899 | узкие скиллы для распознавания текста и разбора документов, а ImageSorcery добавляет правку и поиск объектов | |
| MeiGen AI Design MCP | да | API-ключ | 1 792 | создает изображения и видео облачными моделями, а ImageSorcery правит готовые файлы локально |
Коротко о README
Для каждого инструмента, ресурса и промпта в папках проекта лежит отдельное описание с подробностями и примерами запросов. Для Cline есть готовая инструкция установки, которую можно вставить как запрос.