Image Generator MCP Server

Generador de imágenes del servidor MCP

Un servidor MCP que utiliza Replicate para generar imágenes y permite a los usuarios guardarlas.

Componentes

Recursos

El servidor implementa un sistema de almacenamiento de imágenes con:

• Imagen personalizada:// Esquema de URI para acceder a imágenes individuales generadas
• Cada recurso de imagen tiene un nombre basado en su solicitud, una descripción con fecha de creación y un tipo MIME de imagen/png.

Indicaciones

El servidor proporciona un único mensaje:

• generate-image: Crea indicaciones para generar imágenes usando Stable Diffusion
  • Argumento opcional "estilo" para controlar el estilo de la imagen (realista/artístico/abstracto)
  • Genera una plantilla de solicitud con orientación específica de estilo.

Herramientas

El servidor implementa tres herramientas:

• generate-image: genera una imagen utilizando el modelo de difusión estable de Replicate
  • Toma "prompt" como un argumento de cadena obligatorio
  • Los parámetros opcionales incluyen "negative_prompt", "width", "height", "num_inference_steps" y "guidance_scale".
  • Devuelve la imagen generada y su URL
• save-image: guarda una imagen generada en el sistema de archivos local
  • Toma "image_url" y "prompt" como argumentos de cadena obligatorios
  • Genera una identificación única para la imagen y la guarda en el directorio "generated_images"
• list-saved-images: enumera todas las imágenes guardadas
  • Devuelve una lista de todas las imágenes guardadas con sus metadatos y miniaturas.

Configuración

Replicar token de API

Para utilizar este generador de imágenes, necesita un token de API de replicación:

1. Crea una cuenta en Replicate
2. Obtenga su token API desde https://replicate.com/account
3. Cree un archivo .env basado en la plantilla .env.example proporcionada:

Importante: El archivo .env se excluye del control de versiones mediante .gitignore para evitar la exposición accidental de su token de API. Nunca envíe información confidencial a su repositorio.

Configuración del entorno

1. Clonar el repositorio:

2. Crear y activar un entorno virtual:

3. Instalar dependencias:

4. Configure su archivo .env como se describe arriba

Inicio rápido

Instalar

Escritorio de Claude

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

Uso

Una vez que el servidor esté en funcionamiento, puedes:

1. Genere una imagen utilizando la herramienta "generar imagen" con una indicación descriptiva
2. Guarde la imagen generada usando la herramienta "guardar imagen" con la URL de la imagen y el mensaje
3. Ver todas las imágenes guardadas usando la herramienta "lista-de-imágenes-guardadas"
4. Acceda a las imágenes guardadas a través de la lista de recursos

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

1. Sincronizar dependencias y actualizar el archivo de bloqueo:

2. Distribuciones de paquetes de compilación:

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

3. Publicar en PyPI:

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

• Token: --token o UV_PUBLISH_TOKEN
• O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.