Pollinations MCP Server

Servidor MCP Pollinations

Esta é uma implementação de servidor baseada no Model Context Protocol (MCP) para conectar-se à API do serviço Pollinations.ai. Este servidor permite que modelos de IA chamem as funcionalidades de geração de imagem e texto do Pollinations.ai por meio do protocolo MCP.

Recursos

• Suporte à interação com o serviço Pollinations.ai por meio do protocolo MCP
• Fornece três ferramentas principais:
  • generate_image: Gera imagens usando Pollinations.ai e retorna a URL (sem marca d'água por padrão)
  • download_image: Baixa a imagem gerada para um arquivo local
  • generate_text: Gera texto usando Pollinations.ai
• Implementado em TypeScript, com segurança de tipos
• Usa mecanismo de transporte stdio, facilitando a integração com modelos de IA

Instalação

1. Clone o repositório:

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

2. Instale as dependências:

npm install

3. Compile o projeto:

npm run build

Como usar

Executar como servidor MCP

npm start

O servidor será iniciado via entrada/saída padrão (stdio), aguardando conexão de clientes MCP.

Usar no Cursor (pode não funcionar atualmente)

Observação: Atualmente, configurar este servidor no Cursor pode não funcionar. Se você precisar desse recurso, recomendamos usar o Cline (veja abaixo).

Usar no Cline (recomendado)

Cline é um terminal de IA que suporta o protocolo MCP e pode usar com sucesso os recursos de geração de imagem deste servidor. Etapas de configuração:

1. Instale e inicie o Cline

2. Abra o arquivo de configuração do Cline, geralmente localizado em:

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

3. No arquivo de configuração, encontre ou adicione a seção mcpServers e adicione a seguinte configuração:

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

Por exemplo, a configuração completa em um sistema Windows pode ser assim:

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

4. Salve o arquivo de configuração e reinicie o Cline
5. Agora você pode usar os recursos de geração de imagem do Pollinations no Cline, por exemplo:

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

Integração com modelos de IA

Este servidor foi projetado para integração com modelos de IA que suportam o protocolo MCP, permitindo que eles gerem imagens.

Ferramentas suportadas

generate_image

Gera imagens usando Pollinations.ai e retorna a URL.

Parâmetros:

• prompt (obrigatório): prompt de descrição da imagem
• width (opcional): largura da imagem (pixels), padrão 1024
• height (opcional): altura da imagem (pixels), padrão 1024
• seed (opcional): valor de semente aleatória (para gerar imagens consistentes)
• model (opcional): modelo a ser usado, padrão 'flux'
• nologo (opcional): defina como true para remover a marca d'água, padrão true
• enhance (opcional): melhora a qualidade da imagem (aplica filtro de aprimoramento), padrão false
• safe (opcional): ativa filtro de segurança (filtra conteúdo impróprio), padrão false
• private (opcional): defina como true para tornar a imagem privada (não exibida no feed público), padrão false

Melhores práticas para prompts:

• Escreva os prompts em inglês sempre que possível; o Pollinations.ai entende melhor o inglês
• Mantenha os prompts curtos e precisos, evite descrições longas ou vagas
• Use adjetivos e substantivos específicos, em vez de conceitos abstratos
• Por exemplo: "beautiful sunset over ocean with palm trees" funciona melhor do que "uma imagem de pôr do sol"

download_image

Baixa imagens geradas pelo Pollinations.ai para um arquivo local.

Parâmetros:

• url (obrigatório): URL da imagem a ser baixada
• output_path (opcional): caminho para salvar a imagem (incluindo nome do arquivo), padrão 'image.jpg'

generate_text

Gera texto usando Pollinations.ai.

Parâmetros:

• prompt (obrigatório): prompt de texto
• model (opcional): modelo a ser usado (como openai, mistral, etc.), padrão 'openai'
• seed (opcional): valor de semente aleatória (para gerar resultados consistentes)
• system (opcional): prompt de sistema (define o comportamento da IA)
• json (opcional): se deve retornar resposta em formato JSON, padrão false
• private (opcional): defina como true para tornar a resposta privada, padrão false

Referência da API

Este projeto usa a API oficial do Pollinations.ai. Documentação completa da API: Documentação da API Pollinations

API de geração de imagens

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

Exemplo:

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

Modelos de imagem disponíveis

• flux (padrão): modelo mainstream de texto para imagem, abrangente
• variation: geração de variações de imagem
• dreamshaper: estilo onírico
• anything: imagens em estilo anime
• pixart: estilo de ilustração de alta qualidade

API de geração de texto

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

Exemplo:

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

Modelos de texto disponíveis

• openai (padrão): modelo OpenAI
• mistral: modelo Mistral
• gemini: modelo Google Gemini

Desenvolvimento

Estrutura do projeto

• src/index.ts: implementação principal do servidor
• dist/: arquivos JavaScript compilados
• package.json: configuração do projeto e dependências

Dependências

• @modelcontextprotocol/sdk: SDK do protocolo MCP
• axios: cliente HTTP, usado para baixar imagens
• typescript: compilador TypeScript

Licença

Este projeto é licenciado sob a licença ISC. Consulte o arquivo LICENSE para obter detalhes.

Links relacionados

• Pollinations.ai
• Model Context Protocol