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

Related MCP server: Image Generation MCP Server

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

1. Solo se requiere el parámetro prompt

2. Todos los parámetros opcionales utilizan valores predeterminados si no se proporcionan

3. Cuando se proporcionan, los parámetros deben cumplir con sus restricciones (por ejemplo, rangos de ancho/alto)

4. Las respuestas Base64 pueden ser grandes: use el formato URL para imágenes más grandes

5. 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:

1. Bifurcar el repositorio

2. Crear una nueva rama ( feature/my-new-feature )

3. Confirme sus cambios

4. Empuja la rama hacia tu tenedor

5. 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.