📦 Обзор проекта
Инструмент TypeScript, позволяющий использовать Ideogram API (v3.0) через сервер MCP.
Многофункциональность, включая генерацию изображений, ссылку на стиль, волшебную подсказку, соотношение сторон, выбор модели и т. д.
Можно использовать немедленно с Claude Desktop и другими клиентами MCP.
Related MCP server: OpenAI MCP
⚡️ Быстрый старт
Если вы хотите подключиться к 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 !
📄 Лицензия
Массачусетский технологический институт
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Sunwood-ai-labs/ideagram-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server