📦 Обзор проекта
Инструмент 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... сборка TypeScriptnpm 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-запросов
🚀 Развертывание и выпуск
Автоматическая публикация npm с помощью GitHub Actions
Обновление версии → Автоматическое развертывание путем отправки тегов
npm version patch|minor|major
git push --follow-tagsПодробности смотрите в docs/npm-deploy.md !
📄 Лицензия
Массачусетский технологический институт
