Pollinations MCP Server

Servidor MCP de Pollinations

Esta es una implementación de servidor basada en Model Context Protocol (MCP) para conectarse a la API del servicio Pollinations.ai. Este servidor permite que los modelos de IA llamen a las funciones de generación de imágenes y texto de Pollinations.ai a través del protocolo MCP.

Características

• Admite interacción con el servicio Pollinations.ai a través del protocolo MCP
• Proporciona tres herramientas principales:
  • generate_image: Genera imágenes usando Pollinations.ai y devuelve una URL (sin marca de agua por defecto)
  • download_image: Descarga la imagen generada a un archivo local
  • generate_text: Genera texto usando Pollinations.ai
• Implementado en TypeScript, con seguridad de tipos
• Utiliza el mecanismo de transporte stdio para facilitar la integración con modelos de IA

Instalación

1. Clonar el repositorio:

git clone https://github.com/bendusy/pollinations-mcp.git
cd pollinations-mcp

2. Instalar dependencias:

npm install

3. Compilar el proyecto:

npm run build

Uso

Ejecutar como servidor MCP

npm start

El servidor se iniciará a través de la entrada/salida estándar (stdio) y esperará la conexión de un cliente MCP.

Uso en Cursor (puede que no funcione actualmente)

Nota: Actualmente, configurar este servidor en Cursor puede no tener éxito. Si necesita usar esta funcionalidad, se recomienda usar Cline (ver más abajo).

Uso en Cline (recomendado)

Cline es una terminal de IA que admite el protocolo MCP y puede usar con éxito la funcionalidad de generación de imágenes proporcionada por este servidor. Pasos de configuración:

1. Instalar e iniciar Cline

2. Abrir el archivo de configuración de Cline, generalmente ubicado en:

   • Windows: %APPDATA%\Cline\config.json
   • Mac: ~/Library/Application Support/Cline/config.json
   • Linux: ~/.config/Cline/config.json

3. En el archivo de configuración, buscar o agregar la sección mcpServers, y luego agregar la siguiente configuración:

"mcpServers": {
  "pollinations-mcp": {
    "command": "node",
    "args": [
      "完整路径/到您的/pollinations-mcp/dist/index.js"
    ],
    "disabled": false,
    "autoApprove": [
      "download_image",
      "generate_image",
      "generate_text"
    ]
  }
}

Por ejemplo, la configuración completa en un sistema Windows podría verse así:

"mcpServers": {
  "pollinations-mcp": {
    "command": "node",
    "args": [
      "C:\\Users\\用户名\\路径\\到\\pollinations-mcp\\dist\\index.js"
    ],
    "disabled": false,
    "autoApprove": [
      "download_image",
      "generate_image",
      "generate_text"
    ]
  }
}

4. Guardar el archivo de configuración y reiniciar Cline
5. Ahora puede usar la funcionalidad de generación de imágenes de Pollinations en Cline, por ejemplo:

使用Pollinations生成图像：beautiful sunset over ocean with palm trees

Integración con modelos de IA

Este servidor está diseñado para integrarse con modelos de IA que admiten el protocolo MCP, permitiéndoles generar imágenes.

Herramientas compatibles

generate_image

Genera imágenes usando Pollinations.ai y devuelve una URL.

Parámetros:

• prompt (obligatorio): Prompt de descripción de la imagen
• width (opcional): Ancho de la imagen (píxeles), por defecto 1024
• height (opcional): Alto de la imagen (píxeles), por defecto 1024
• seed (opcional): Valor de semilla aleatoria (para generar imágenes consistentes)
• model (opcional): Modelo a usar, por defecto 'flux'
• nologo (opcional): Establecer en true para eliminar la marca de agua, por defecto true
• enhance (opcional): Mejorar la calidad de la imagen (aplica filtros de mejora), por defecto false
• safe (opcional): Habilitar filtro de seguridad (filtra contenido inapropiado), por defecto false
• private (opcional): Establecer en true para que la imagen sea privada (no se muestra en el feed público), por defecto false

Mejores prácticas para prompts:

• Intente escribir los prompts en inglés, Pollinations.ai entiende mejor el inglés
• Mantenga los prompts cortos y precisos, evite descripciones demasiado largas o ambiguas
• Use adjetivos y sustantivos concretos, en lugar de conceptos abstractos
• Por ejemplo: "beautiful sunset over ocean with palm trees" funciona mejor que "una imagen de una puesta de sol"

download_image

Descarga la imagen generada por Pollinations.ai a un archivo local.

Parámetros:

• url (obligatorio): URL de la imagen a descargar
• output_path (opcional): Ruta para guardar la imagen (incluido el nombre del archivo), por defecto 'image.jpg'

generate_text

Genera texto usando Pollinations.ai.

Parámetros:

• prompt (obligatorio): Prompt de texto
• model (opcional): Modelo a usar (como openai, mistral, etc.), por defecto 'openai'
• seed (opcional): Valor de semilla aleatoria (para generar resultados consistentes)
• system (opcional): Prompt del sistema (configura el comportamiento de la IA)
• json (opcional): Si devolver la respuesta en formato JSON, por defecto false
• private (opcional): Establecer en true para que la respuesta sea privada, por defecto false

Referencia de API

Este proyecto utiliza la API oficial de Pollinations.ai. Para la documentación completa de la API, consulte: Documentación de la API de Pollinations

API de generación de imágenes

Formato básico: https://image.pollinations.ai/prompt/{prompt}?{参数}

Ejemplo:

https://image.pollinations.ai/prompt/beautiful%20sunset?width=1024&height=1024&nologo=true

Modelos de imagen disponibles

• flux (por defecto): Modelo principal de texto a imagen, funcionalidad completa
• variation: Generación de variantes de imagen
• dreamshaper: Estilo de ensueño
• anything: Imágenes de estilo anime
• pixart: Estilo de ilustración de alta calidad

API de generación de texto

Formato básico: https://text.pollinations.ai/{prompt}?{参数}

Ejemplo:

https://text.pollinations.ai/Tell%20me%20about%20artificial%20intelligence?model=openai

Modelos de texto disponibles

• openai (por defecto): Modelo OpenAI
• mistral: Modelo Mistral
• gemini: Modelo Google Gemini

Desarrollo

Estructura del proyecto

• src/index.ts: Implementación principal del servidor
• dist/: Archivos JavaScript compilados
• package.json: Configuración del proyecto y dependencias

Dependencias

• @modelcontextprotocol/sdk: SDK del protocolo MCP
• axios: Cliente HTTP, para descargar imágenes
• typescript: Compilador de TypeScript

Licencia

Este proyecto está licenciado bajo la licencia ISC. Consulte el archivo LICENSE para más detalles.

Enlaces relacionados

• Pollinations.ai
• Model Context Protocol