@qmediat.io/ideogram-mcp

MCP-сервер для Ideogram V3 API — генерация, редактирование, ремикс, апскейл и описание изображений из Claude Code, Claude Desktop или любого MCP-клиента.

Почему этот сервер?

• 7 инструментов — полное покрытие Ideogram V3 (генерация, редактирование, ремикс, рефрейм, замена фона, апскейл, описание)

• Безопасность прежде всего — защита от SSRF, отклонение симлинков, проверка Content-Type, предотвращение path traversal, валидация ответов через Zod (подробности)

• 2 зависимости времени выполнения — @modelcontextprotocol/sdk + zod. Без axios, без form-data, без HTTP-библиотек

• Нативный Ideogram API — прямые V3-эндпоинты, не через прокси fal.ai или Replicate

• Готовность к продакшену — повторные попытки с экспоненциальной задержкой, обработка фильтров безопасности, устойчивость к частичным сбоям

Related MCP server: ideogram-mcp-server

Быстрый старт

npm install -g @qmediat.io/ideogram-mcp

Или используйте напрямую:

npx @qmediat.io/ideogram-mcp

Требуется IDEOGRAM_API_KEY — получите его на ideogram.ai/manage-api.

Конфигурация

Claude Code

Добавьте в ~/.claude.json → mcpServers:

{
  "ideogram": {
    "command": "npx",
    "args": ["-y", "@qmediat.io/ideogram-mcp"],
    "env": {
      "IDEOGRAM_API_KEY": "your-api-key",
      "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
    }
  }
}

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "ideogram": {
      "command": "npx",
      "args": ["-y", "@qmediat.io/ideogram-mcp"],
      "env": {
        "IDEOGRAM_API_KEY": "your-api-key",
        "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
      }
    }
  }
}

Переменные окружения

Доступные инструменты

Общие параметры

Безопасность

Этот сервер разработан с подходом нулевого доверия и минимальных зависимостей:

• Защита от SSRF — загрузка только по HTTPS, белый список хостов, блокировка перенаправлений

• Отклонение симлинков — lstat() отклоняет созданные пользователем симлинки перед чтением

• Проверка Content-Type — загрузки должны быть image/*, отклоняются HTML/JSON страницы ошибок

• Валидация ответов через Zod — ответы API разбираются через схемы, без слепых приведений типов

• Предотвращение path traversal — белый список расширений + проверка вложенности через path.relative()

Полные подробности в SECURITY.md.

Разработка

git clone https://github.com/qmediat/ideogram-mcp.git
cd ideogram-mcp
npm install
npm run build

Запуск локально:

IDEOGRAM_API_KEY=your-key node dist/index.js

Участие в разработке

См. CONTRIBUTING.md для руководства по архитектуре и требований к PR.

Лицензия

MIT — Quantum Media Technologies