exif-mcp

BSD 2-Clause "Simplified" License

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

LLM(또는 사람)이 오프라인 상태에서도 이미지 메타데이터를 온디맨드로 읽을 수 있도록 하는 MCP 서버입니다. 뛰어난 Exifr 라이브러리를 기반으로 하며, 매우 빠르며 외부 도구에 의존하지 않습니다.

사용 사례:

  • 이미지 메타데이터를 분석하고 시각화합니다.
  • 이미지 라이브러리를 분석해 보세요. 가장 많이 사용하는 카메라는 무엇인가요? 렌즈 종류는 무엇인가요? 요일별로 사진을 가장 많이 찍는 요일은 언제인가요? 가장 좋아하는 장소는 무엇인가요?
  • 이미지 조작 코드 디버깅.

이 도구는 역방향 지리위치 서비스 PlaceSpotter 에서 개발 및 테스트를 위해 광범위하게 사용됩니다.

개요

exif-mcp 이미지에서 다양한 메타데이터 세그먼트를 추출하는 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. TypeScript로 구축되었으며, 뛰어난 Exifr 라이브러리를 활용하여 JPEG, PNG, TIFF, HEIC와 같은 일반적인 형식의 이미지에서 메타데이터를 파싱합니다. 이를 통해 외부 도구를 실행하지 않고도 이미지 메타데이터를 파싱할 수 있어 매우 효율적이고 보안성이 뛰어납니다.

특징

  • 로컬 작업 : 원격 네트워크가 필요 없이 완전히 오프라인으로 작동합니다.
  • 다중 세그먼트 : EXIF, GPS, XMP, ICC, IPTC, JFIF 및 IHDR 메타데이터 추출
  • 다양한 입력 포맷 지원 : JPEG, TIFF, HEIC/AVIF, PNG 지원
  • 유연한 이미지 소스 : 파일 시스템, URL, base64 데이터 또는 버퍼에서 읽기
  • 특수 도구 : 방향, 회전 정보, GPS 좌표 및 썸네일 가져오기

설치

지엑스피1

용법

클로드 데스크탑

Claude 구성 파일(claude_desktop_config.json)에 다음을 넣으세요.

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

Claude를 다시 시작하세요. 이제 Claude에게 이미지를 검사하거나 특정 카메라로 촬영한 파일을 찾아달라고 요청할 수 있습니다. 이 기능은 Claude가 파일을 찾고 디렉터리를 나열할 수 있도록 파일 시스템 MCP 도구와 함께 사용하면 가장 효과적입니다.

서버 시작

# Start the server npm start # For development with auto-reload npm run dev

서버는 MCP SDK의 StdioServerTransport 사용하므로 STDIO 전송을 지원하는 모든 MCP 클라이언트와 호환됩니다.

mcp-proxy를 사용하면 원격 액세스를 활성화할 수 있습니다.

사용 가능한 도구

서버에서 제공하는 도구는 다음과 같습니다.

도구 이름설명
read-metadata모든 또는 지정된 메타데이터 세그먼트를 읽습니다.
read-exifEXIF 데이터를 특별히 읽습니다
read-xmpXMP 데이터를 읽습니다
read-iccICC 색상 프로파일 데이터를 읽습니다.
read-iptcIPTC 메타데이터를 읽습니다
read-jfifJFIF 세그먼트 데이터를 읽습니다.
read-ihdrIHDR 세그먼트 데이터를 읽습니다.
orientation이미지 방향(1-8)을 가져옵니다.
rotation-info회전 및 뒤집기 정보를 가져옵니다.
gps-coordinatesGPS 좌표를 추출합니다
thumbnail내장된 썸네일을 추출합니다

MCP Inspector를 사용한 디버깅

  1. 검사기를 시작합니다: npx @modelcontextprotocol/inspector node dist/server.js
  2. STDIO 전송을 사용하여 MCP Inspector로 연결합니다.
  3. 예를 들어 매개변수를 사용하여 read-metadata 와 같은 도구를 호출합니다.
    { "image": { "kind": "path", "path": "/path/to/image.jpg" } }
  4. MCP 검사기 명령줄을 다음과 같이 사용할 수도 있습니다. 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="[]"

이미지 소스 유형

서버는 이미지 데이터를 제공하는 여러 가지 방법을 지원합니다.

// 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..." }

개발

테스트 실행

# Run tests npm test # Run tests with watch mode npm run test:watch

프로젝트 구조

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

오류 처리

서버는 일반적인 문제에 대한 표준화된 오류 처리를 제공합니다.

  • 지원되지 않는 형식 또는 누락된 메타데이터
  • 네트워크 페치 실패
  • 대형 탑재물
  • 내부 Exifr 오류

특허

BSD 2절

감사의 말

  • Exifr - 매우 빠르고 강력한 EXIF 파싱 라이브러리

You must be authenticated.

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

LLM이나 사람이 exifr 라이브러리를 사용하여 이미지에서 메타데이터를 추출하고 분석할 수 있는 오프라인 MCP 서버로, 외부 도구 없이도 다양한 이미지 형식과 메타데이터 세그먼트를 지원합니다.

  1. 개요
    1. 특징
  2. 설치
    1. 용법
      1. 클로드 데스크탑
      2. 서버 시작
      3. 사용 가능한 도구
      4. MCP Inspector를 사용한 디버깅
      5. 이미지 소스 유형
    2. 개발
      1. 테스트 실행
      2. 프로젝트 구조
    3. 오류 처리
      1. 특허
        1. 감사의 말

          Related MCP Servers

          • -
            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
          • 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
          • 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
          • -
            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