exif-mcp

Un servidor MCP que permite a los LLM (o a los usuarios) leer metadatos de imágenes bajo demanda, completamente sin conexión. Basado en la excelente biblioteca exifr, es extremadamente rápido y no depende de herramientas externas.

Casos de uso:

• Analizar metadatos de imágenes y visualizarlos

• Analiza tu biblioteca de imágenes: ¿Cuáles son mis cámaras más usadas? ¿Cuál es mi distribución de lentes? ¿En qué fechas de la semana tomo más fotos? ¿Cuáles son mis ubicaciones favoritas?

• Depuración de código de manipulación de imágenes.

Esta herramienta es ampliamente utilizada por el servicio de geolocalización inversa PlaceSpotter para desarrollo y pruebas.

Descripción general

exif-mcp es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para extraer diversos segmentos de metadatos de imágenes. Desarrollado con TypeScript, utiliza la excelente biblioteca exifr para analizar metadatos de imágenes en formatos comunes como JPEG, PNG, TIFF y HEIC. Esto permite que este servicio analice metadatos de imágenes sin necesidad de herramientas externas, lo que le confiere alta eficiencia y seguridad.

Características

• Operación local : funciona completamente sin conexión sin necesidad de red remota

• Segmentos múltiples : extrae metadatos EXIF, GPS, XMP, ICC, IPTC, JFIF e IHDR

• Varios formatos de entrada : admite JPEG, TIFF, HEIC/AVIF y PNG

• Fuentes de imágenes flexibles : lectura desde el sistema de archivos, URL, datos base64 o búferes

• Herramientas especializadas : Obtenga orientación, información de rotación, coordenadas GPS y miniaturas

Related MCP server: mcp-video

Instalación

# Clone the repository
git clone https://github.com/stass/exif-mcp.git
cd exif-mcp

# Install dependencies
npm install

# Build the project
npm run build

Uso

Escritorio de Claude

Coloque esto en el archivo de configuración de Claude (claude_desktop_config.json):

"mcpServers": {
    "exif-mcp": {
      "command": "node",
      "args": [
        "/path/to/exif-mcp/dist/server.js"
      ]
    }
  },

Reinicia Claude. Ahora puedes pedirle que inspeccione imágenes o, por ejemplo, que busque archivos tomados con una cámara específica. Esto funciona mejor en combinación con las herramientas MCP del sistema de archivos, para que Claude pueda encontrar archivos y listar directorios.

Iniciando el servidor

# Start the server
npm start

# For development with auto-reload
npm run dev

El servidor utiliza StdioServerTransport del SDK de MCP, lo que lo hace compatible con cualquier cliente MCP que admita el transporte STDIO.

Puede utilizar mcp-proxy para habilitar el acceso remoto.

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

Depuración con MCP Inspector

1. Inicie el inspector: npx @modelcontextprotocol/inspector node dist/server.js

2. Conéctese a él con MCP Inspector usando el transporte STDIO

3. Llamar a una herramienta, por ejemplo, read-metadata con el parámetro:

   {
     "image": {
       "kind": "path",
       "path": "/path/to/image.jpg"
     }
   }

4. También puede usar la línea de comandos del inspector MCP de esta manera: npx @modelcontextprotocol/inspector --cli node dist/server.js --method tools/call --tool-name read-exif --tool-arg image='{"kind": "path", "path": "/path/to/image.jpeg"}' --tool-arg pick="[]"

Tipos de fuentes de imágenes

El servidor admite varias formas de proporcionar datos de imágenes:

// From local file system
{
  "kind": "path",
  "path": "/path/to/image.jpg"
}

// From URL (http, https, or file://)
{
  "kind": "url",
  "url": "https://example.com/image.jpg"
}

// From base64 data (raw or data URI)
{
  "kind": "base64",
  "data": "data:image/jpeg;base64,/9j/4AAQSkZ..."
}

// From base64 buffer
{
  "kind": "buffer",
  "buffer": "/9j/4AAQSkZ..."
}

Desarrollo

Ejecución de pruebas

# Run tests
npm test

# Run tests with watch mode
npm run test:watch

Estructura del proyecto

exif-mcp/
├── src/
│   ├── server.ts         # Main entry point
│   ├── tools/
│   │   ├── index.ts      # Tool registration
│   │   ├── loaders.ts    # Image loading utilities
│   │   └── segments.ts   # exifr options builders
│   └── types/
│       └── image.ts      # Type definitions
├── tests/                # Test files
└── README.md

Manejo de errores

El servidor proporciona un manejo de errores estandarizado para problemas comunes:

• Formatos no compatibles o metadatos faltantes

• Fallos en la búsqueda de red

• Cargas útiles de gran tamaño

• Errores exifr internos

Licencia

BSD de 2 cláusulas

Expresiones de gratitud

• exifr - Biblioteca de análisis EXIF extremadamente rápida y robusta