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.

Image Generation MCP Server

Integrations