MCPollinations Multimodal MCP Server

Servidor MCP multimodal MCPollinations

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA generar imágenes, texto y audio a través de las API de polinización.

Características

• Generar URL de imágenes a partir de indicaciones de texto
• Genera imágenes y devuélvelas como datos codificados en base64 Y guárdalas como png, jpeg, jpg o webp (predeterminado: png)
• Generar respuestas de texto a partir de indicaciones de texto
• Generar respuestas de audio a partir de indicaciones de texto
• Lista de modelos de generación de imágenes y texto disponibles
• No se requiere autenticación
• Sencillo y ligero
• Compatible con el Protocolo de Contexto de Modelo (MCP)

Requisitos del sistema

• Node.js : Versión 14.0.0 o superior
  • Para un mejor rendimiento, recomendamos Node.js 16.0.0 o superior
  • Las versiones de Node.js anteriores a la 16 utilizan un polyfill AbortController

Inicio rápido

Instalación mediante herrería

Para instalar mcpollinations para Claude Desktop automáticamente a través de Smithery :

La forma más sencilla de utilizar el servidor MCP:

Si prefieres instalarlo globalmente:

O clonar el repositorio:

Integración MCP

Para integrar el servidor con aplicaciones que admiten el Protocolo de contexto de modelo (MCP):

1. Generar un archivo de configuración MCP:

2. Siga las instrucciones para personalizar su configuración o utilizar los valores predeterminados.
   • Establezca una salida personalizada y directorios temporales (el valor predeterminado son rutas relativas para portabilidad)
   • Configurar parámetros predeterminados para la generación de imágenes (con una lista de modelos disponibles, dimensiones, etc.)
   • Configurar parámetros predeterminados para la generación de texto (con una lista de modelos disponibles)
   • Configurar parámetros predeterminados para la generación de audio (voz)
   • Especificar qué herramientas deben estar permitidas
3. Copie el archivo mcp.json generado al archivo .json de configuración MCP de su aplicación.
4. Reinicie su aplicación.

Después de la integración, puedes usar comandos como:

Genera una imagen de una puesta de sol sobre el océano usando MCPollinations.

Solución de problemas

Error "AbortController no está definido"

Si encuentra este error al ejecutar el servidor MCP:

Esto suele deberse a una versión anterior de Node.js (anterior a la 16.0.0). Pruebe una de estas soluciones:

1. Actualizar Node.js (recomendado):
   • Actualice a Node.js 16.0.0 o más reciente
2. Utilizar la instalación global
   • Actualización a la última versión del paquete: GXP7
3. Instalar AbortController manualmente :
   • Si por alguna razón el polyfill no funciona: GXP8

Comprueba tu versión de Node.js

Para comprobar su versión actual de Node.js:

Si muestra una versión inferior a 16.0.0, considere actualizar para obtener una mejor compatibilidad.

Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas:

1. generateImageUrl : genera una URL de imagen a partir de un mensaje de texto.
2. generateImage : genera una imagen, la devuelve como datos codificados en base64 y la guarda en un archivo de forma predeterminada (formato PNG)
3. respondAudio : genera una respuesta de audio a una solicitud de texto (parámetro de voz personalizable)
4. respondText : responde con texto a una solicitud utilizando modelos de texto (parámetro de modelo personalizable)
5. listImageModels : enumera los modelos disponibles para la generación de imágenes
6. listTextModels : enumera los modelos disponibles para la generación de texto
7. listAudioVoices : enumera todas las voces disponibles para la generación de audio

Detalles de generación de imágenes

Comportamiento predeterminado

Al utilizar la herramienta generateImage :

• Las imágenes se guardan en el disco de forma predeterminada como archivos PNG
• La ubicación de guardado predeterminada es el directorio de trabajo actual donde se ejecuta el servidor MCP
• El modelo 'flujo' se utiliza por defecto
• Se genera una semilla aleatoria de forma predeterminada para cada imagen (lo que garantiza la variedad)
• Los datos de imagen codificados en Base64 siempre se devuelven, independientemente de si la imagen está guardada en un archivo

Personalización de la generación de imágenes

Dónde se guardan las imágenes

Al utilizar Claude u otra aplicación con el servidor MCP:

1. Las imágenes se guardan en el directorio de trabajo actual donde se ejecuta el servidor MCP , no donde está instalado Claude o la aplicación cliente.
2. Si inicia el servidor MCP manualmente desde un directorio específico, las imágenes se guardarán allí de forma predeterminada.
3. Si Claude Desktop inicia el servidor MCP automáticamente, las imágenes se guardarán en el directorio de trabajo de Claude Desktop (normalmente en una carpeta de datos de la aplicación).

Cómo encontrar las imágenes generadas

• La respuesta de Claude después de generar una imagen incluye la ruta completa del archivo donde se guardó la imagen
• Puede especificar una ubicación familiar utilizando el parámetro outputPath
• Práctica recomendada: pídale a Claude que guarde las imágenes en una carpeta de fácil acceso, como su directorio de Imágenes o Descargas.

Nombres de archivos únicos

El servidor MCP garantiza que las imágenes generadas siempre tengan nombres de archivo únicos y nunca sobrescribirán los archivos existentes:

1. Los nombres de archivo predeterminados incluyen:
   • Una versión desinfectada del mensaje (primeros 20 caracteres)
   • Una marca de tiempo
   • Un sufijo aleatorio
2. Los nombres de archivos personalizados también están protegidos:
   • Si especifica un nombre de archivo y ya existe un archivo con ese nombre, se agregará automáticamente un sufijo numérico
   • Por ejemplo: sunset.png , sunset_1.png , sunset_2.png , etc.

Esto significa que puede generar de forma segura múltiples imágenes con el mismo mensaje o nombre de archivo sin preocuparse por sobrescribir las imágenes anteriores.

Acceso a datos Base64

Incluso al guardar en un archivo, los datos de imagen codificados en base64 siempre se devuelven y se pueden usar para:

• Incrustar en páginas web ( <img src="data:image/png;base64,..." /> )
• Pasar a otros servicios o API
• Procesamiento en memoria sin operaciones del sistema de archivos
• Visualización en aplicaciones que admiten URI de datos

Para desarrolladores

Si desea utilizar el paquete en sus propios proyectos: