Image Generator

Genera y guarda imágenes usando la API de Replicate.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP Image Generator

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:

  • Esquema de URI personalizado image:// para acceder a imágenes generadas individualmente
  • Cada recurso de imagen tiene un nombre basado en su prompt, descripción con fecha de creación y tipo MIME image/png

Prompts

El servidor proporciona un único prompt:

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

Herramientas

El servidor implementa tres herramientas:

  • generate-image: Genera una imagen usando el modelo Stable Diffusion de Replicate
    • Toma "prompt" como 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 un ID único para la imagen y la guarda en el directorio "generated_images"
  • list-saved-images: Lista todas las imágenes guardadas
    • Devuelve una lista de todas las imágenes guardadas con sus metadatos y miniaturas

Configuración

Token de API de Replicate

Para usar este generador de imágenes, necesitas un token de API de Replicate:

  1. Crea una cuenta en Replicate
  2. Obtén tu token de API desde https://replicate.com/account
  3. Crea un archivo .env basado en la plantilla .env.example proporcionada:
REPLICATE_API_TOKEN=your_replicate_api_token_here

Importante: El archivo .env está excluido del control de versiones mediante .gitignore para evitar exponer accidentalmente tu token de API. Nunca comprometas información sensible en tu repositorio.

Configuración del entorno

  1. Clona el repositorio:
git clone https://github.com/yourusername/image-generator.git
cd image-generator
  1. Crea y activa un entorno virtual:
# Using venv
python -m venv .venv
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate
  1. Instala las dependencias:
pip install -r requirements.txt
  1. Configura tu archivo .env como se describió anteriormente

Inicio rápido

Instalación

Claude Desktop

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

Configuración de Servidores No Publicados ``` "mcpServers": { "image-generator": { "command": "uv", "args": [ "--directory", "B:\NEWTEST\image-generator", "run", "image-generator" ] } } ```
Configuración de Servidores Publicados ``` "mcpServers": { "image-generator": { "command": "uvx", "args": [ "image-generator" ] } } ```

Uso

Una vez que el servidor esté en ejecución, puedes:

  1. Generar una imagen usando la herramienta "generate-image" con un prompt descriptivo
  2. Guardar la imagen generada usando la herramienta "save-image" con la URL de la imagen y el prompt
  3. Ver todas las imágenes guardadas usando la herramienta "list-saved-images"
  4. Acceder a las imágenes guardadas a través de la lista de recursos

Desarrollo

Compilación y publicación

Para preparar el paquete para distribución:

  1. Sincroniza las dependencias y actualiza el archivo de bloqueo:
uv sync
  1. Compila las distribuciones del paquete:
uv build

Esto creará distribuciones de código fuente y wheel en el directorio dist/.

  1. Publica en PyPI:
uv publish

Nota: Necesitarás configurar las credenciales de PyPI mediante variables de entorno o banderas 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 sobre stdio, la depuración puede ser desafiante. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el MCP Inspector.

Puedes iniciar el MCP Inspector mediante npm con este comando:

npx @modelcontextprotocol/inspector uv --directory B:\NEWTEST\image-generator run image-generator

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