MCP Image Placeholder Server

Servidor MCP Image Placeholder

Este é um servidor Model Context Protocol (MCP) que fornece uma ferramenta para gerar imagens de placeholder de diferentes provedores.

Recursos

• Gera imagens de placeholder de provedores suportados
• Suporta dois provedores de imagem:
  • placehold: Fornece imagens de placeholder simples
  • lorem-picsum: Fornece imagens reais como placeholders
• Valida parâmetros de entrada
• Retorna URLs de imagem para uso imediato

Requisitos

• Python 3.9+
• Gerenciador de pacotes uv

Instalação

1. Clone este repositório
2. Configure o servidor MCP

Uso

O servidor expõe uma ferramenta:

image_placeholder

Gera uma URL de imagem de placeholder com base nos parâmetros especificados.

Parâmetros:

• provider: O provedor de imagem a ser usado (placehold ou lorem-picsum)
• width: A largura da imagem (1-10000)
• height: A altura da imagem (1-10000)

Retorno:

• String de URL da imagem gerada

Exemplo de Uso:

# Generate a 300x200 placeholder image
url = image_placeholder(provider="placehold", width=300, height=200)

# Generate a 500px square lorem-picsum image
url = image_placeholder(provider="lorem-picsum", width=500)

Configuração

Para conectar este servidor ao Claude for Desktop:

1. Adicione o seguinte ao seu claude_desktop_config.json:

   {
       "mcpServers": {
           "image-placeholder": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/ABSOLUTE/PATH/TO/PROJECT",
                   "run",
                   "main.py"
               ]
           }
       }
   }
   

2. Reinicie o Claude for Desktop

Para conectar este servidor ao Cursor:

1. Abra as Configurações do Cursor
2. Vá para a seção Features
3. Role até a seção MCP Servers
4. Clique no botão Add new MCP server
5. Insira as seguintes informações:
   • Nome: image-placeholder
   • Tipo: command
   • URL do servidor: uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py
6. Clique no botão Add ↵

Solução de Problemas

Se a ferramenta não for detectada, use o caminho absoluto do comando uv, por exemplo:

/ABSOLUTE/PATH/TO/uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py

Exemplo de Uso e Saída (Cursor)

Prompt:

Create a new directory named "example" and a file named output.html.

Then create a single modern looking page using tailwindcss: https://unpkg.com/@tailwindcss/browser@4

Show a nice header, content, and footer, showing a photo gallery.

Save this into output.html

Saída: Exemplo de Saída (Cursor)

Licença

Licença MIT