Servidor MCP de generación de imágenes

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite la generación fluida de imágenes de alta calidad utilizando el modelo Flux.1 Schnell mediante Together AI. Este servidor proporciona una interfaz estandarizada para especificar los parámetros de generación de imágenes.

Características

Generación de imágenes de alta calidad impulsada por el modelo Flux.1 Schnell
Soporte para dimensiones personalizables (ancho y alto)
Manejo claro de errores para una rápida validación y problemas de API
Fácil integración con clientes compatibles con MCP
Guardado opcional de imagen en disco en formato PNG

Instalación

npm install together-mcp

O ejecutar directamente:

npx together-mcp@latest

Configuración

Agregue a su configuración de servidor MCP:

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

Uso

El servidor proporciona una herramienta: generate_image

Usando generate_image

Esta herramienta solo requiere un parámetro: el mensaje. Los demás parámetros son opcionales y, si no se proporcionan, se utilizan valores predeterminados razonables.

Parámetros

{
  // 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
}

Ejemplo de solicitud mínima

Solo se requiere el mensaje:

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

Ejemplo de solicitud completa con guardado de imagen

Anule los valores predeterminados y especifique una ruta para guardar la imagen:

{
  "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"
  }
}

Formato de respuesta

La respuesta será un objeto JSON que contendrá:

{
  "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")
    }
  ]
}

Si se proporcionó image_path y el guardado se realizó correctamente, la respuesta incluirá la confirmación de la ubicación de guardado.

Valores predeterminados

Si no se especifica en la solicitud, se utilizan estos valores predeterminados:

Modelo: "black-forest-labs/FLUX.1-schnell-Free"
ancho: 1024
altura: 768
pasos: 1
n: 1
formato_de_respuesta: "b64_json"

Notas importantes

Solo se requiere el parámetro prompt
Todos los parámetros opcionales utilizan valores predeterminados si no se proporcionan
Cuando se proporcionan, los parámetros deben cumplir con sus restricciones (por ejemplo, rangos de ancho/alto)
Las respuestas Base64 pueden ser grandes: use el formato URL para imágenes más grandes
Al guardar imágenes, asegúrese de que el directorio especificado exista y se pueda escribir en él.

Prerrequisitos

Node.js >= 16
Clave API de Together AI
1. Inicie sesión en api.together.xyz
2. Vaya a la configuración de claves API
3. Haga clic en "Crear" para generar una nueva clave API
4. Copie la clave generada para usarla en su configuración de MCP

Dependencias

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

Desarrollo

Clonar y construir el proyecto:

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

Scripts disponibles

npm run build - Construye el proyecto TypeScript
npm run watch : vigila los cambios y reconstruye
npm run inspector - Ejecutar el inspector MCP

Contribuyendo

¡Agradecemos sus contribuciones! Siga estos pasos:

Bifurcar el repositorio
Crear una nueva rama ( feature/my-new-feature )
Confirme sus cambios
Empuja la rama hacia tu tenedor
Abrir una solicitud de extracción

Las solicitudes de funciones y los informes de errores se pueden enviar a través de GitHub Issues. Por favor, revise los problemas existentes antes de crear uno nuevo.

Para cambios significativos, primero abra un problema para discutir los cambios propuestos.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

generate_image

Un servidor de protocolo de contexto de modelo que permite la generación de imágenes de alta calidad utilizando el modelo Flux.1 Schnell a través de Together AI con parámetros personalizables.

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
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
15
Python
MIT License
MCP Replicate FLUX
andylee20014
A
security
F
license
A
quality
A Model Context Protocol server that generates images using Replicate's FLUX model and stores them in Cloudflare R2, allowing users to create images through simple prompts and retrieve accessible URLs.
Last updated -
1
10
Flux Schnell MCP Server
ckz
-
security
A
license
-
quality
A server that enables generating images through the Replicate API by calling the Flux Schnell model via the Model Context Protocol (MCP).
Last updated -
3
JavaScript
MIT License

View all related MCP servers

Image Generation MCP Server