Servidor MCP CleverUtils

Endpoint do servidor

O servidor MCP fala JSON-RPC 2.0 sobre HTTP em:

https://cleverutils.com/mcp

Implementa o transporte Streamable HTTP (POST para requisições JSON-RPC). Sem estado de sessão, sem autenticação, limitado por IP a 1000 requisições por dia.

Conectar pelo Claude Desktop

{
  "mcpServers": {
    "cleverutils": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://cleverutils.com/mcp"]
    }
  }
}

{
  "mcpServers": {
    "cleverutils": {
      "url": "https://cleverutils.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "cleverutils": {
      "url": "https://cleverutils.com/mcp"
    }
  }
}

Ferramentas disponíveis

O servidor expõe 15 ferramentas. Todas as entradas aceitam uma URL HTTPS (o servidor busca com proteção SSRF) ou um arquivo codificado em base64. As saídas são retornadas como blocos MCP resource_link apontando para uma URL de download válida por 2 horas.

Exemplos de prompts

Uma vez conectado, você pode pedir ao LLM coisas como:

• "Converta https://example.com/photo.heic para JPG."
• "Amplie esta imagem em 4x: https://example.com/icon.png"
• "Remova o fundo de https://example.com/portrait.jpg e me dê o PNG transparente."
• "Transcreva este podcast como legendas SRT em inglês: https://example.com/episode.mp3"
• "Comprima este PDF para aproximadamente 50% do tamanho original: https://example.com/report.pdf"
• "Mescle estes três PDFs em um: https://…/a.pdf, https://…/b.pdf, https://…/c.pdf"

Como funciona

1. O LLM escolhe uma ferramenta. Com base na sua solicitação, o LLM consulta a lista de ferramentas e escolhe uma (por exemplo, upscale_image) com os argumentos corretos.
2. O servidor busca o arquivo. Se você passou uma URL, o servidor a baixa do lado do servidor — atrás de uma lista de bloqueio SSRF rigorosa (sem IPs privados, sem file://, sem DNS rebinding).
3. A conversão é executada. O mesmo motor do nosso site e API REST: ImageMagick, FFmpeg, Real-ESRGAN, Demucs, Whisper, Ghostscript, LibreOffice.
4. O resultado é retornado como link de recurso. O LLM recebe uma resposta estruturada contendo texto legível ("Arquivo convertido: photo.jpg, 180 KB") e um resource_link legível por máquina com uma URL de download válida por 2 horas.

Teste a partir do seu terminal

Se você só quer verificar se o servidor funciona sem configurar um cliente MCP completo, tente este curl:

curl -X POST https://cleverutils.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": {"name": "curl", "version": "1.0"}
    }
  }'

curl -X POST https://cleverutils.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

curl -X POST https://cleverutils.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "convert_file",
      "arguments": {
        "file": "https://example.com/photo.heic",
        "to_format": "jpg"
      }
    }
  }'

Limites e cotas

• 1000 chamadas de ferramenta por dia por IP
• 150 chamadas por hora por IP
• 1 segundo de cooldown entre chamadas consecutivas
• Máx. 200 MB por arquivo (menos para algumas ferramentas de IA pesadas)
• Máx. 20 arquivos em um lote (por exemplo, merge_pdfs)
• 2 horas de retenção para URLs de saída convertidas
• Ferramentas de IA pesadas (upscale, vocal-remover, colorize etc.) têm um limite mais restrito de 50/dia

Mesmo modelo da API REST. Consulte /api/rate-limits para detalhes completos.

Segurança

O servidor é exposto publicamente sem autenticação, então levamos a segurança a sério:

• Proteção SSRF: URLs de arquivos são buscadas do lado do servidor com uma lista de bloqueio rigorosa de faixas de IP privadas (RFC1918, link-local, metadados AWS, IPv6 ULA). DNS rebinding é mitigado fixando o IP resolvido. Apenas esquemas http(s):// são permitidos.
• Limites de tamanho: teto rígido de 200 MB por download, aplicado durante o download em streaming (abortamos no meio da transferência).
• Sem persistência: todos os arquivos de entrada e saídas convertidas são excluídos após 2 horas.
• Registro anônimo: aplicamos hash (SHA-256 com sal) aos IPs dos chamadores para limitação de taxa e detecção de abuso. IPs em texto claro nunca são armazenados.
• Limitação de taxa: limitador idêntico de 5 níveis da nossa API REST.

E se eu for o LLM, não o humano?

Se você (o modelo) está lendo esta página porque o usuário colou a URL, você pode:

1. Sugerir que o usuário adicione o servidor à configuração MCP dele (snippets acima).
2. Ou, se já tiver acesso HTTP, chamar POST https://cleverutils.com/mcp com o corpo JSON-RPC mostrado nos exemplos de curl — isso funciona sem integração de cliente MCP.
3. Sempre comece com tools/list para descobrir o catálogo atual de ferramentas e os esquemas de parâmetros.

Veja também

• Página inicial da API CleverUtils — a API REST subjacente
• Início rápido da API REST — para uso não-LLM
• Referência de endpoints REST
• Limites de taxa
• modelcontextprotocol.io — a especificação MCP