Skip to main content
Glama
Sign In
deenesjakoruzh
Ideogram MCP Server

Ideogram MCP Server

by Sunwood-ai-labs
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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

  • Инструмент 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 ... сборка 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
└── ...（省略）

📝 Вклады

  1. Форк этого репозитория

  2. Создайте новую ветку ( git checkout -b feature/awesome )

  3. Внесение изменений (сообщения о внесении изменений должны быть на японском языке, рекомендуется использовать эмодзи!)

  4. Создание push- и pull-запросов

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

  • Автоматическая публикация npm с помощью GitHub Actions

  • Обновление версии → Автоматическое развертывание путем отправки тегов

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

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

📄 Лицензия

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

Available Tools

1 tool
generate_imageC

Generate an image using Ideogram AI

Inputs: prompt (required), aspect_ratio, resolution, seed, +11 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    C2.9/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'generate_image' has a clearly distinct and unambiguous purpose.

    Naming Consistency5/5

    A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'generate_image' follows a clear verb_noun pattern.

    Tool Count2/5

    One tool is too few for a server named 'Ideogram MCP Server', which suggests a broader scope for image generation or AI tasks. A single tool feels thin and limited for such a domain.

    Completeness2/5

    The tool surface is severely incomplete for an image generation server. It only offers generation with no options for editing, listing, deleting, or managing images, creating significant gaps in functionality.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches