MCP Image Downloader

MCP Image Downloader

Um servidor MCP que fornece ferramentas para baixar e otimizar imagens. Construído usando o Model Context Protocol (MCP), este servidor permite que assistentes de IA baixem imagens de URLs e realizem tarefas básicas de otimização de imagens.

Recursos

• Baixar imagens de URLs com tratamento adequado de erros
• Otimizar imagens com opções para:
  • Redimensionamento (mantendo a proporção)
  • Ajuste de qualidade (JPEG/WebP)
  • Conversão de formato

Instalação

# Clone the repository
git clone https://github.com/qpd-v/mcp-image-downloader.git
cd mcp-image-downloader

# Install dependencies
npm install

# Build the project
npm run build

Uso

Como um servidor MCP

Adicione o servidor à sua configuração MCP (por exemplo, na configuração do Claude Desktop):

{
  "mcpServers": {
    "image-downloader": {
      "command": "node",
      "args": ["/path/to/mcp-image-downloader/build/index.js"]
    }
  }
}

Ferramentas disponíveis

download_image

Baixa uma imagem de uma URL para um caminho especificado.

Parâmetros:

• url: URL da imagem a ser baixada
• outputPath: Caminho onde salvar a imagem

optimize_image

Cria uma versão otimizada de uma imagem.

Parâmetros:

• inputPath: Caminho para a imagem de entrada
• outputPath: Caminho onde salvar a imagem otimizada
• width (opcional): Largura alvo (mantém a proporção se apenas a largura for especificada)
• height (opcional): Altura alvo (mantém a proporção se apenas a altura for especificada)
• quality (opcional): Qualidade JPEG/WebP (1-100)

Desenvolvimento

# Run in development mode
npm run start

# Build the project
npm run build

Requisitos

• Node.js 16 ou superior
• NPM ou gerenciador de pacotes compatível

Licença

Licença MIT - veja o arquivo LICENÇA para detalhes.

Autor

qpd-v

Versão

0.1.0 - Lançamento inicial