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.

Related MCP server: MCP Server for Replicate

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:

REPLICATE_API_TOKEN=your_replicate_api_token_here

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:

git clone https://github.com/yourusername/image-generator.git
cd image-generator

2. Crear y activar un entorno virtual:

# Using venv
python -m venv .venv
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate

3. Instalar dependencias:

pip install -r requirements.txt

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:

uv sync

2. Distribuciones de paquetes de compilación:

uv build

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

3. Publicar en PyPI:

uv publish

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:

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

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