RelayOne Image MCP

Este es el paquete de integración MCP de RelayOne Image, compatible con las dos rutas de generación de imágenes: Image2 y Gemini Banana. Cada usuario solo necesita configurar una clave de API de RelayOne.

Dos proveedores de generación de imágenes

Banana también admite gemini-3-pro-image. Su imageSize son niveles de nitidez 512, 1K, 2K, 4K, y aspectRatio controla la proporción; no es el protocolo de tamaño fijo ancho x alto de Image2.

Related MCP server: Gemini Image Generation MCP Server

Modelos compatibles

Image2

Gemini Banana

gemini-3-pro-image-preview se normaliza a gemini-3-pro-image; es un alias, no un tercer modelo independiente. Tanto el texto a imagen como la imagen a imagen de los dos modelos Banana llaman a la misma interfaz generateContent; la presencia o ausencia de reference_images determina si es texto a imagen o imagen a imagen.

Al elegir el proveedor, MCP selecciona automáticamente el protocolo:

• image2 llama a /v1/images/generations JSON cuando no hay reference_images; cuando hay imágenes de referencia, llama a /v1/images/edits multipart y sube las imágenes de referencia con image[].

• banana siempre llama a /v1beta/models/{model}:generateContent; las imágenes de referencia se convierten en contents[].parts[].inlineData, no es multipart ni OpenAI Images JSON.

Contenido que debe completar el sitio

1. config/providers.json ya tiene configurados la dirección de RelayOne, el modelo y la ruta de Images; modifíquelo solo si necesita cambiar de sitio.

2. Cada agente copia .env.example a .env y solo completa SITE_IMAGE_API_KEY; no escriba la clave en los parámetros de la herramienta.

3. Si se necesita un proxy, configure adicionalmente SITE_IMAGE_PROXY_URL en la máquina que ejecuta MCP; es opcional.

4. Si el sitio no usa autenticación Bearer o no es un formato de solicitud compatible con OpenAI, modifique la lógica de adaptación en callProvider y el esquema de solicitud de src/index.ts.

5. Ejecute npm install, npm run build y luego registre dist/index.js en el cliente MCP.

.env se lee automáticamente al iniciar MCP, por lo que el agente no necesita modificar el comando de inicio.

Ejemplo de registro en MCP

Reemplace PACKAGE_DIRECTORY en mcp-server.example.json con el directorio del paquete actual y luego registre según el formato de configuración del cliente MCP utilizado. .env y dist/index.js deben estar al mismo nivel que ese directorio.

Herramientas

• list_image_providers: muestra los canales configurados localmente, sin mostrar claves.

• list_remote_image_models: lee el inventario de modelos en tiempo real, no genera imágenes.

• get_image_capabilities: consulta las capacidades de parámetros completadas por el administrador del sitio.

• get_image_usage: lee la interfaz de uso opcional, no genera imágenes.

• prepare_image_request: previsualiza el JSON real, sin conexión.

• generate_image: antes de llamarla, debe proporcionar la ruta absoluta local save_directory. La herramienta conserva el JSON de respuesta original completo (incluidos url y b64_json) y guarda la imagen en ese directorio, a la vez que devuelve el contenido de imagen image de MCP.

Parámetros personalizados por llamada

Los campos estándar se pasan directamente; los campos específicos del sitio se colocan en custom_parameters. Por ejemplo:

{
  "prompt": "一座雨夜城市",
  "size": "1024x1024",
  "custom_parameters": {
    "steps": 30,
    "guidance_scale": 7,
    "seed": 12345,
    "negative_prompt": "模糊、低清晰度"
  }
}

custom_parameters se fusiona en el JSON de la solicitud actual; provider, model, prompt, custom_parameters y los campos estándar ya pasados no se pueden sobrescribir.

Restricciones de seguridad

• Las claves reales solo se colocan en el entorno de inicio; no se escriben en providers.json, código, registros ni parámetros de herramientas MCP.

• El usuario debe elegir explícitamente save_directory antes de cada generación de imágenes; MCP no decide la ubicación de guardado por sí mismo.

• En el directorio de guardado se genera un archivo de respuesta original .response.json, así como archivos de imagen nombrados por número de secuencia.

• La descarga de imágenes por URL solo permite HTTP(S) y está limitada a 25 MB; si la descarga falla, la URL original permanece en .response.json.

• Las solicitudes y respuestas no imprimen el encabezado Authorization.

• El paso directo arbitrario de advanced no se ha añadido a la plantilla; el administrador del sitio debe añadir los campos a la lista blanca uno por uno según su propia interfaz.

Registro en Codex

Registre node dist/index.js en la configuración MCP de Codex y pase la clave de RelayOne mediante variables de entorno configuradas. No ponga valores reales en los archivos de ejemplo ni los envíe a terceros.

Dirección del proyecto: https://github.com/linshiqiyyds/relayone-image-mcp

Ejemplo de llamada de generación de imágenes

Al llamar a generate_image, primero debe elegir el directorio de guardado, por ejemplo:

{
  "prompt": "一只橘猫坐在窗边，电影感，自然光",
  "size": "1024x1024",
  "response_format": "b64_json",
  "save_directory": "D:\\RelayOne-MCP\\generated"
}

Si elige response_format: "url", MCP descargará la imagen correspondiente a la URL; si elige b64_json, MCP decodificará el Base64. Ambos campos originales se guardan tal cual en el archivo .response.json.

Ejemplo de Image2

{
  "provider": "image2",
  "model": "gpt-image-2",
  "prompt": "一张产品摄影图",
  "size": "2048x1152",
  "response_format": "url",
  "save_directory": "D:\\RelayOne-MCP\\generated"
}

Para imagen a imagen de Image2, solo necesita añadir la ruta local de la imagen de referencia; MCP cambiará automáticamente a /v1/images/edits:

{
  "provider": "image2",
  "model": "gpt-image-2",
  "prompt": "保留主体，把背景改成夜晚城市",
  "reference_images": ["D:\\References\\product.png"],
  "size": "2048x1152",
  "save_directory": "D:\\RelayOne-MCP\\generated"
}

Ejemplo de Banana

{
  "provider": "banana",
  "model": "gemini-3.1-flash-image",
  "prompt": "把产品放在夜晚城市街道中",
  "aspectRatio": "16:9",
  "imageSize": "2K",
  "reference_images": [
    "D:\\References\\product.png"
  ],
  "save_directory": "D:\\RelayOne-MCP\\generated"
}

Las imágenes de referencia de Banana se leen como Base64 puro y se colocan en contents[].parts[].inlineData según el protocolo nativo de Gemini. Hasta 14 imágenes, cada una de máximo 20 MB, con soporte para PNG, JPEG y WebP. Los modelos de Banana no usan gpt-image-2 ni el campo size de píxeles fijos de Image2.