Skip to main content
Glama
Sign In
enesjakozh

exif-mcp

by stass
GitHub
TypeScript
BSD 2-Clause "Simplified" License
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Licensed under BSD 2-clause, allowing users to modify and distribute the software under the terms of this permissive license.

  • Hosted on GitHub where users can clone the repository to install and use the exif-mcp server.

  • Extracts EXIF, GPS, XMP, ICC, IPTC, JFIF metadata from JPEG images, providing tools for analyzing orientation, rotation info, GPS coordinates, and thumbnails.

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

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:

Nombre de la herramientaDescripción
read-metadataLee todos los segmentos de metadatos o los especificados
read-exifLee datos EXIF específicamente
read-xmpLee datos XMP
read-iccLee datos del perfil de color ICC
read-iptcLee metadatos IPTC
read-jfifLee datos del segmento JFIF
read-ihdrLee datos del segmento IHDR
orientationObtiene la orientación de la imagen (1-8)
rotation-infoObtiene información de rotación y giro.
gps-coordinatesExtrae coordenadas GPS
thumbnailExtrae la miniatura incrustada

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

View all tools

Un servidor MCP sin conexión que permite a los LLM o a los humanos extraer y analizar metadatos de imágenes utilizando la biblioteca exifr, compatible con varios formatos de imagen y segmentos de metadatos sin herramientas externas.

  1. Descripción general
    1. Características
  2. Instalación
    1. Uso
      1. Escritorio de Claude
      2. Iniciando el servidor
      3. Herramientas disponibles
      4. Depuración con MCP Inspector
      5. Tipos de fuentes de imágenes
    2. Desarrollo
      1. Ejecución de pruebas
      2. Estructura del proyecto
    3. Manejo de errores
      1. Licencia
        1. Expresiones de gratitud

          Related Resources

          Related MCP Servers

          • MCP Read Images

            catalystneuro
            -
            security
            A
            license
            -
            quality
            An MCP server for analyzing images using OpenRouter vision models, offering capabilities like automatic image resizing, model configuration, and handling custom queries about images.
            Last updated -
            5
            JavaScript
            MIT License

          • image-tools-mcp

            kshern
            A
            security
            A
            license
            A
            quality
            Image Tools MCP is a Model Context Protocol (MCP) service that retrieves image dimensions and compresses images from URLs and local files using the TinyPNG API. It supports converting images to formats like webp, jpeg/jpg, and png, providing detailed information on width, height, type, and compressi
            Last updated -
            4
            11
            3
            JavaScript
            MIT License
            • Apple

          • file-finder-mcp

            StepanCooleague
            A
            security
            F
            license
            A
            quality
            A MCP server that allows searching for files in the filesystem based on path fragments, returning file metadata including name, path, size, and creation date.
            Last updated -
            1
            Python
            • Apple

          • Tripadvisor MCP

            pab1it0
            -
            security
            A
            license
            -
            quality
            MCP server that enables LLMs to interact with Tripadvisor API, supporting location data, reviews, and photos through standardized MCP interfaces
            Last updated -
            Python
            MIT License
            • Linux
            • Apple

          View all related MCP servers

          ID: 5hxbqhlnlk