MCP Image Extractor

MCP Image Extractor

Servidor MCP para extraer y convertir imágenes a base64 para el análisis con LLM.

Este servidor MCP proporciona herramientas para que los asistentes de IA puedan:

• Extraer imágenes de archivos locales
• Extraer imágenes de URLs
• Procesar imágenes codificadas en base64

Cómo se ve en Cursor:

Casos de uso adecuados:

• analizar resultados de pruebas de playwright: capturas de pantalla

Instalación

Recomendado: Usar npx en mcp.json (lo más fácil)

La forma recomendada de instalar este servidor MCP es usando npx directamente en tu archivo .cursor/mcp.json:

{
  "mcpServers": {
    "image-extractor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image-extractor"
      ]
    }
  }
}

Este enfoque:

• Instala automáticamente la última versión
• No requiere instalación global
• Funciona de manera confiable en diferentes entornos

Alternativa: Instalación con ruta local

Si prefieres usar una instalación local del paquete, puedes clonar el repositorio y apuntar a los archivos compilados:

{
  "mcpServers": {
    "image-extractor": {
      "command": "node",
      "args": ["/full/path/to/mcp-image-extractor/dist/index.js"],
      "disabled": false
    }
  }
}

Instalación manual

# Clone and install 
git clone https://github.com/ifmelate/mcp-image-extractor.git
cd mcp-image-extractor
npm install
npm run build
npm link

Esto hará que el comando mcp-image-extractor esté disponible globalmente.

Luego configura en .cursor/mcp.json:

{
  "mcpServers": {
    "image-extractor": {
      "command": "mcp-image-extractor",
      "disabled": false
    }
  }
}

Solución de problemas para usuarios de Cursor: Si ves el error "Failed to create client", prueba el método de instalación con ruta local mencionado arriba o asegúrate de estar usando la ruta correcta al ejecutable.

Herramientas disponibles

extract_image_from_file

Extrae una imagen de un archivo local y la convierte a base64.

Parámetros:

• file_path (obligatorio): Ruta al archivo de imagen local

Nota: Todas las imágenes se redimensionan automáticamente a dimensiones óptimas (máx. 512x512) para el análisis con LLM, con el fin de limitar el tamaño de la salida base64 y optimizar el uso de la ventana de contexto.

extract_image_from_url

Extrae una imagen de una URL y la convierte a base64.

Parámetros:

• url (obligatorio): URL de la imagen a extraer

Nota: Todas las imágenes se redimensionan automáticamente a dimensiones óptimas (máx. 512x512) para el análisis con LLM, con el fin de limitar el tamaño de la salida base64 y optimizar el uso de la ventana de contexto.

extract_image_from_base64

Procesa una imagen codificada en base64 para el análisis con LLM.

Parámetros:

• base64 (obligatorio): Datos de imagen codificados en base64
• mime_type (opcional, predeterminado: "image/png"): Tipo MIME de la imagen

Nota: Todas las imágenes se redimensionan automáticamente a dimensiones óptimas (máx. 512x512) para el análisis con LLM, con el fin de limitar el tamaño de la salida base64 y optimizar el uso de la ventana de contexto.

Ejemplo de uso

Aquí hay un ejemplo de cómo usar las herramientas desde Claude:

Please extract the image from this local file: images/photo.jpg

Claude usará automáticamente la herramienta extract_image_from_file para cargar y analizar el contenido de la imagen.

Please extract the image from this URL: https://example.com/image.jpg

Claude usará automáticamente la herramienta extract_image_from_url para obtener y analizar el contenido de la imagen.

Docker

Compilar y ejecutar con Docker:

docker build -t mcp-image-extractor .
docker run -p 8000:8000 mcp-image-extractor

Licencia

MIT