Name: Ideogram MCP Server
Author: Sunwood-ai-labs

📦 Обзор проекта

Инструмент TypeScript, позволяющий использовать Ideogram API (v3.0) через сервер MCP.
Многофункциональность, включая генерацию изображений, ссылку на стиль, волшебную подсказку, соотношение сторон, выбор модели и т. д.
Можно использовать немедленно с Claude Desktop и другими клиентами MCP.

Related MCP server: Image Generation MCP Server

⚡️ Быстрый старт

Если вы хотите подключиться к Claude Desktop или другим клиентам MCP с молниеносной скоростью,
Просто скопируйте и вставьте приведенный ниже фрагмент JSON в свой файл конфигурации! ✨

{ "mcpServers": { "ideogram": { "command": "npx", "args": [ "@sunwood-ai-labs/ideagram-mcp-server" ], "env": { "IDEOGRAM_API_KEY": "your_api_key_here" } } } }

🛠️ Характеристики инструмента MCP

сгенерировать_изображение

Список параметров (последняя версия)

Параметры	Тип	объяснение	Обязательно/Необязательно	замечания
быстрый	нить	Запрос на создание изображения (рекомендуется английский)	Необходимый
соотношение сторон	нить	Соотношение сторон (например, «1x1», «16x9», «4x3» и т. д.)	любой	15 видов
разрешение	нить	Разрешение (см. официальную документацию, всего 69 типов)	любой
семя	целое число	Случайное числовое значение (для обеспечения воспроизводимости)	любой	0 до 2147483647
magic_prompt	нить	Волшебная подсказка ("АВТО"	"НА"	"ВЫКЛЮЧЕННЫЙ"
скорость_рендеринга	нить	Скорость рендеринга для v3 ("TURBO"	"ПО УМОЛЧАНИЮ"	"КАЧЕСТВО"
коды_стилей	нить[]	Последовательность кода в стиле 8 символов	любой
тип_стиля	нить	Тип стиля ("АВТО"	"ОБЩИЙ"	"РЕАЛИСТИЧЕСКИЙ"
отрицательный_запрос	нить	Исключения (рекомендуется английский)	любой
num_images	число	Количество сгенерированных изображений (от 1 до 8)	любой
style_reference	объект	Справочник стилей (Новое в Ideogram 3.0)	любой	Подробности ниже
└ URL-адреса	нить[]	Массив URL-адресов справочных изображений (до 3)	любой
└ код_стиля	нить	Код стиля	любой
└ случайный_стиль	булев	Использовать случайный стиль	любой
выходной_каталог	нить	Каталог хранения изображений (по умолчанию: «docs»)	любой
базовое_имя_файла	нить	Основа для имени сохраненного файла (по умолчанию: «ideogram-image»)	любой	Присвоение метки времени и идентификатора
размытие_маски	булев	Размыть края изображения (установить значение true для наложения масок)	любой	По умолчанию: ложно

📝 Пример использования

const result = await use_mcp_tool({ server_name: "ideagram-mcp-server", tool_name: "generate_image", arguments: { prompt: "A beautiful sunset over mountains", aspect_ratio: "16x9", rendering_speed: "QUALITY", num_images: 2, style_reference: { urls: [ "https://example.com/ref1.jpg", "https://example.com/ref2.jpg" ], random_style: false }, blur_mask: true } });

🧑‍💻 Разработка, сборка и тестирование

npm run build ... сборка TypeScript
npm run watch ... режим разработки (автоматическая сборка)
npm run lint ... Анализ кода
npm test ... запустить тесты

🗂️ Структура каталога

ideagram-mcp-server/ ├── assets/ ├── docs/ │ └── ideogram-image_2025-05-18T06-31-45-777Z.png ├── src/ │ ├── tools/ │ ├── types/ │ ├── utils/ │ ├── ideogram-client.ts │ ├── index.ts │ ├── server.ts │ └── test.ts ├── .env.example ├── package.json ├── tsconfig.json ├── README.md └── ...（省略）

📝 Вклады

Форк этого репозитория
Создайте новую ветку ( git checkout -b feature/awesome )
Внесение изменений (сообщения о внесении изменений должны быть на японском языке, рекомендуется использовать эмодзи!)
Создание push- и pull-запросов