Image-Gen-Server — MCP-сервер генерации изображений через 即梦 (Jimeng AI)
Image-Gen-Server — это MCP-сервер, который интегрируется с Cursor IDE (а также с любыми Claude-совместимыми MCP-хостами) и позволяет генерировать изображения по текстовому описанию. Сервер использует API китайской платформы 即梦 (Jimeng AI), автоматически сохраняет картинки на диск и возвращает результат обратно в среду разработки.
Проект написан на Python с использованием FastMCP. Для работы требуется Python 3.10+, Node.js v20+ и пакетный менеджер uv.
Возможности
- Генерация изображения по текстовому запросу (prompt).
- Одноразовая генерация сразу четырёх вариантов изображения.
- Автоматическое сохранение с заданным именем и в указанную папку.
- Поддержка нескольких аккаунтов 即梦 (через список sessionid).
- Настраиваемые параметры: ширина, высота, детализация (sample_strength).
- Полная интеграция с Cursor в режиме Agent.
Установка
-
Системные требования:
- Python ≥ 3.10
- Node.js ≥ v20 (проверено на v20)
- npm (для Inspector)
uv — менеджер проектов Python (pip install uv)
-
Клонируйте репозиторий:
git clone https://github.com/fengin/image-gen-server.git
cd image-gen-server
-
Установите зависимости:
pip install -r requirements.txt
pip install uv
-
(Опционально) Для отладки установите MCP Inspector:
npm install -g @modelcontextprotocol/inspector@0.4.0
Настройка
Отредактируйте файл server.py — задайте два параметра:
JIMENG_API_TOKEN = "sessionid_1,sessionid_2" # один или несколько sessionid через запятую
IMG_SAVA_FOLDER = "/path/to/save/images" # папка для сохранения по умолчанию
Как получить sessionid для 即梦
- Перейдите на https://jimeng.jianying.com.
- Войдите в аккаунт.
- Откройте Инструменты разработчика (F12) → Application → Cookies.
- Найдите cookie с именем
sessionid и скопируйте его значение.
Важно: sessionid — это токен авторизации. Храните его в секрете, не публикуйте в открытых репозиториях.
Интеграция с Cursor IDE
-
Откройте Settings → Features → MCP Servers.
-
Нажмите Add new MCP server.
-
Заполните:
- Name:
image-gen-server (или любое имя)
- Type:
command
- Command: укажите команду запуска, подставив свой путь к
server.py:
Windows:
uv run --with fastmcp fastmcp run D:/code/image-gen-server/server.py
macOS / Linux:
uv run --with fastmcp fastmcp run /Users/username/code/image-gen-server/server.py
-
После добавления сервера должно появиться чёрное консольное окно. Если окно исчезает и статус — No tools found, проверьте:
- правильность пути (избегайте кириллицы в пути, используйте
/ или \\);
- установлены ли все зависимости;
- запустите команду вручную в терминале (cmd, PowerShell, bash) — это поможет найти ошибку.
Использование
В Cursor переключитесь в режим Agent и дайте команду, например:
Создай логотип для моего проекта, сохрани в папку images с именем logo.jpg
Сервер поддерживает следующие параметры (можно передать в запросе):
- prompt (строка, обязательный) — текстовое описание изображения.
- file_name (строка, обязательный) — имя файла. Если без расширения, будет добавлен
.jpg.
- save_folder (строка, опционально) — путь для сохранения. По умолчанию —
IMG_SAVA_FOLDER.
- sample_strength (float, 0–1) — детализация (по умолчанию 0.5).
- width / height (int, по умолчанию 1024) — размер изображения.
Для отладки
Замените run на dev в команде запуска:
uv run --with fastmcp fastmcp dev D:/code/image-gen-server/server.py
После этого откройте в браузере http://localhost:5173 — там будет доступен MCP Inspector, через который можно отправлять запросы к серверу и просматривать логи.
Структура проекта
server.py — основная точка входа, реализует MCP-сервер через FastMCP.
proxy/jimeng/ — модуль для взаимодействия с 即梦 AI (обратный прокси к API Jimeng).
- Поддерживает генерацию изображений, синхронное и потоковое завершение диалога.
- Умеет работать с несколькими токенами.
Лицензия
MIT. Автор: 凌封.
Часто задаваемые вопросы (FAQ)
Q: После настройки окно быстро закрывается, MCP-сервер показывает «No tools found».
A: Проверьте:
- путь к
server.py — не содержит ли кириллицы, правильно ли экранированы слэши.
- все ли зависимости установлены (
pip install -r requirements.txt, pip install uv).
- попробуйте запустить команду вручную в терминале — увидите конкретную ошибку.
Q: Как сменить токен 即梦?
A: Отредактируйте JIMENG_API_TOKEN в server.py и перезапустите MCP-сервер (переподключите в Cursor).
Комментарии
Комментариев пока нет. Будьте первым.