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)

Related MCP server: MCP Toolkit

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 :

npx -y @smithery/cli install @pinkpixel-dev/mcpollinations --client claude

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

# Run directly with npx (no installation required)
npx @pinkpixel/mcpollinations

Si prefieres instalarlo globalmente:

# Install globally
npm install -g @pinkpixel/mcpollinations

# Run the server
mcpollinations
# or
npx @pinkpixel/mcpollinations

O clonar el repositorio:

# Clone the git repository
git clone https://github.com/pinkpixel-dev/mcpollinations.git
# Run the server
mcpollinations
# or
npx @pinkpixel/mcpollinations
# or run directly
node /path/to/MCPollinations/pollinations-mcp-server.js

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:

# If installed globally
npx @pinkpixel/mcpollinations generate-config

# Or run directly
node /path/to/MCPollinations/generate-mcp-config.js

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:

ReferenceError: AbortController is not defined

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:

node --version

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

// Example options for generateImage
const options = {
  // Model selection (defaults to 'flux')
  model: "flux",

  // Image dimensions
  width: 1024,
  height: 1024,

  // Generation options
  seed: 12345,  // Specific seed for reproducibility (defaults to random)
  enhance: true,  // Enhance the prompt using an LLM before generating (defaults to true)
  safe: false,  // Content filtering (defaults to false)

  // File saving options
  saveToFile: true,  // Set to false to skip saving to disk
  outputPath: "/path/to/save/directory",  // Custom save location
  fileName: "my_custom_name",  // Without extension
  format: "png"  // png, jpeg, jpg, or webp
};

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:

# Install as a dependency
npm install @pinkpixel/mcpollinations

# Import in your code
import { generateImageUrl, generateImage, repsondText, respondAudio, listTextModels, listImageModels, listAudioVoices } from '@pinkpixel/mcpollinations';