MCP Image Downloader

MCP Image Downloader

Un servidor MCP que proporciona herramientas para descargar y optimizar imágenes. Construido utilizando el Protocolo de Contexto de Modelos (MCP), este servidor permite a los asistentes de IA descargar imágenes desde URLs y realizar tareas básicas de optimización de imágenes.

Características

• Descarga imágenes desde URLs con manejo adecuado de errores
• Optimiza imágenes con opciones para:
  • Redimensionamiento (manteniendo la proporción de aspecto)
  • Ajuste de calidad (JPEG/WebP)
  • Conversión de formato

Instalación

# 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 servidor MCP

Agrega el servidor a tu configuración de MCP (por ejemplo, en la configuración de Claude Desktop):

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

Herramientas disponibles

download_image

Descarga una imagen desde una URL a una ruta especificada.

Parámetros:

• url: URL de la imagen a descargar
• outputPath: Ruta donde guardar la imagen

optimize_image

Crea una versión optimizada de una imagen.

Parámetros:

• inputPath: Ruta de la imagen de entrada
• outputPath: Ruta donde guardar la imagen optimizada
• width (opcional): Ancho objetivo (mantiene la proporción de aspecto si solo se especifica el ancho)
• height (opcional): Alto objetivo (mantiene la proporción de aspecto si solo se especifica el alto)
• quality (opcional): Calidad JPEG/WebP (1-100)

Desarrollo

# Run in development mode
npm run start

# Build the project
npm run build

Requisitos

• Node.js 16 o superior
• NPM o administrador de paquetes compatible

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.

Autor

qpd-v

Versión

0.1.0 - Versión inicial