Сервер MCP для создания изображений

Сервер Model Context Protocol (MCP), который обеспечивает бесшовную генерацию высококачественных изображений с использованием модели Flux.1 Schnell через Together AI. Этот сервер предоставляет стандартизированный интерфейс для указания параметров генерации изображений.

Функции

• Генерация высококачественных изображений на основе модели Flux.1 Schnell

• Поддержка настраиваемых размеров (ширина и высота)

• Четкая обработка ошибок для быстрой проверки и решения проблем API

• Простая интеграция с MCP-совместимыми клиентами

• Возможность сохранения изображения на диск в формате PNG

Related MCP server: Image Generation MCP Server

Установка

npm install together-mcp

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

npx together-mcp@latest

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

Добавьте в конфигурацию вашего сервера MCP:

{
  "mcpServers": {
    "together-image-gen": {
      "command": "npx",
      "args": ["together-mcp@latest -y"],
      "env": {
        "TOGETHER_API_KEY": "<API KEY>"
      }
    }
  }
}

Использование

Сервер предоставляет один инструмент: generate_image

Использование generate_image

Этот инструмент имеет только один обязательный параметр - приглашение. Все остальные параметры являются необязательными и используют разумные значения по умолчанию, если не указаны.

Параметры

{
  // Required
  prompt: string;          // Text description of the image to generate

  // Optional with defaults
  model?: string;          // Default: "black-forest-labs/FLUX.1-schnell-Free"
  width?: number;          // Default: 1024 (min: 128, max: 2048)
  height?: number;         // Default: 768 (min: 128, max: 2048)
  steps?: number;          // Default: 1 (min: 1, max: 100)
  n?: number;             // Default: 1 (max: 4)
  response_format?: string; // Default: "b64_json" (options: ["b64_json", "url"])
  image_path?: string;     // Optional: Path to save the generated image as PNG
}

Пример минимального запроса

Требуется только подсказка:

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A serene mountain landscape at sunset"
  }
}

Полный пример запроса с сохранением изображения

Переопределите все значения по умолчанию и укажите путь для сохранения изображения:

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A serene mountain landscape at sunset",
    "width": 1024,
    "height": 768,
    "steps": 20,
    "n": 1,
    "response_format": "b64_json",
    "model": "black-forest-labs/FLUX.1-schnell-Free",
    "image_path": "/path/to/save/image.png"
  }
}

Формат ответа

Ответ будет представлять собой объект JSON, содержащий:

{
  "id": string,        // Generation ID
  "model": string,     // Model used
  "object": "list",
  "data": [
    {
      "timings": {
        "inference": number  // Time taken for inference
      },
      "index": number,      // Image index
      "b64_json": string    // Base64 encoded image data (if response_format is "b64_json")
      // OR
      "url": string        // URL to generated image (if response_format is "url")
    }
  ]
}

Если был указан image_path и сохранение прошло успешно, ответ будет включать подтверждение места сохранения.

Значения по умолчанию

Если в запросе не указано иное, используются следующие значения по умолчанию:

• модель: "black-forest-labs/FLUX.1-schnell-Free"

• ширина: 1024

• рост: 768

• шаги: 1

• н: 1

• response_format: "b64_json"

Важные примечания

1. Требуется только параметр prompt

2. Все необязательные параметры используют значения по умолчанию, если не указаны.

3. При наличии параметры должны соответствовать ограничениям (например, диапазоны ширины/высоты)

4. Ответы Base64 могут быть большими — используйте формат URL для больших изображений.

5. При сохранении изображений убедитесь, что указанный каталог существует и доступен для записи.

Предпосылки

• Node.js >= 16

• Ключ API Together AI

  1. Войти на api.together.xyz

  2. Перейдите к настройкам API-ключей.

  3. Нажмите «Создать», чтобы сгенерировать новый ключ API.

  4. Скопируйте сгенерированный ключ для использования в вашей конфигурации MCP.

Зависимости

{
  "@modelcontextprotocol/sdk": "0.6.0",
  "axios": "^1.6.7"
}

Разработка

Клонируйте и соберите проект:

git clone https://github.com/manascb1344/together-mcp-server
cd together-mcp-server
npm install
npm run build

Доступные сценарии

• npm run build — сборка проекта TypeScript

• npm run watch — отслеживание изменений и пересборка

• npm run inspector - Запустить инспектор MCP

Внося вклад

Вклады приветствуются! Пожалуйста, выполните следующие шаги:

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

2. Создать новую ветку ( feature/my-new-feature )

3. Примите ваши изменения

4. Подтолкните ветку к своей развилке

5. Открыть запрос на извлечение

Запросы функций и отчеты об ошибках можно отправлять через GitHub Issues. Пожалуйста, проверьте существующие проблемы перед созданием новой.

В случае существенных изменений, пожалуйста, сначала откройте тему, чтобы обсудить предлагаемые вами изменения.

Лицензия

Этот проект лицензирован по лицензии MIT. Подробности см. в файле LICENSE.