Идеограмма MCP Сервер

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

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

🚀 Развертывание и выпуск

Автоматическая публикация npm с помощью GitHub Actions
Обновление версии → Автоматическое развертывание путем отправки тегов

npm version patch|minor|major
git push --follow-tags

Подробности смотрите в docs/npm-deploy.md !

📄 Лицензия

Массачусетский технологический институт

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

generate_image

Сервер Model Context Protocol, предоставляющий возможности генерации изображений с использованием API Ideogram, позволяя пользователям создавать изображения из текстовых подсказок с настраиваемыми параметрами.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP TemplateIO
Lucker631
A
security
F
license
A
quality
A Model Context Protocol server that provides an image generation tool using Templated.io, allowing users to create customized images based on templates with text and image layers.
Last updated -
TypeScript
Image Generation MCP Server
manascb1344
A
security
A
license
A
quality
A Model Context Protocol server that enables high-quality image generation using the Flux.1 Schnell model via Together AI with customizable parameters.
Last updated -
1
29
8
JavaScript
MIT License
Image Generation MCP Server
sarthakkimtani
A
security
A
license
A
quality
A Model Context Protocol server that enables generation of high-quality images using the Flux.1 Schnell model via Together AI, allowing users to create images from text prompts with customizable dimensions.
Last updated -
1
8
Python
MIT License
OpenAI MCP
jezweb
-
security
A
license
-
quality
A Model Context Protocol server enabling AI assistants to generate images through OpenAI's DALL-E API with full support for all available options and fine-grained control.
Last updated -
14
1
JavaScript
MIT License

View all related MCP servers

Ideogram MCP Server