EXIF Metadata

🚀 exif - mcp

exif-mcp は、大規模言語モデル（または人間）が完全にオフラインで必要に応じて画像のメタデータを読み取ることを可能にするMCPサーバーです。優れた exifr ライブラリに基づいており、非常に高速に動作し、外部ツールに一切依存しません。

🚀 クイックスタート

exif-mcp は、画像のさまざまなメタデータセグメントを抽出するためのさまざまなツールを提供するモデルコンテキストプロトコル（MCP）サーバーです。このツールはTypeScriptで記述され、優れた exifr ライブラリを使用して、JPEG、PNG、TIFF、HEICなどの一般的な形式の画像メタデータを解析します。これにより、外部ツールを実行することなく画像メタデータを解析できるため、効率的かつ信頼性が高くなります。

✨ 主な機能

• 画像メタデータの分析と可視化：画像のメタデータを分析し、可視化することができます。
• 画像ライブラリの分析：最もよく使うカメラ、レンズの分布、撮影が多い曜日、好きな撮影場所などを分析できます。
• 画像処理コードのデバッグ：画像処理コードのデバッグに役立ちます。

このツールは、逆地理位置特定サービス PlaceSpotter の開発とテストに使用されています。

📦 インストール

# リポジトリをクローンする
git clone <repository-url>
cd exif-mcp

# 依存関係をインストールする
npm install

# サーバーを起動する
npm start

💻 使用例

基本的な使用法

Claude Desktopの設定

Claude Desktop の設定ファイルに以下の内容を追加します。

{
  "exif-mcp": {
    "serverUrl": "http://localhost:3000"
  }
}

ツールリスト

利用可能なツールの完全なリストとその機能の説明は次のとおりです。

1. メタデータの読み取り：画像のすべてのメタデータ情報を抽出します。
2. EXIFの読み取り：EXIFメタデータを抽出するために専用に使用されます。
3. XMPの読み取り：XMPメタデータを抽出するために専用に使用されます。
4. IPTCの読み取り：IPTCメタデータを抽出するために専用に使用されます。
5. GPSの読み取り：GPS関連のメタデータを抽出するために専用に使用されます。
6. makerNoteの読み取り：カメラ固有の注釈情報を抽出するために専用に使用されます。

画像ロードサポート

exif-mcp は、以下の4つの画像ロード方法をサポートしています。

1. ファイルパス
2. Web URL
3. Base64文字列
4. Bufferオブジェクト

📚 ドキュメント

プロジェクト構造

exif-mcp/
├── src/
│   ├── server.ts         # メインエントリポイント
│   ├── tools/
│   │   ├── index.ts      # ツールの登録
│   │   ├── loaders.ts    # 画像ロードツールクラス
│   │   └── segments.ts   # exifrオプションビルダー
│   └── types/
│       └── image.ts      # 型定義
├── tests/                # テストファイル
└── README.md             # プロジェクト説明ドキュメント

エラー処理

exif-mcp は、一般的な問題に対する標準的なエラー処理メカニズムを提供します。

• サポートされていない形式またはメタデータの欠如
• ネットワーク取得の失敗
• 負荷過多
• 内部exifrエラー

📄 ライセンス

BSD 2 - clause

謝辞

• exifr - 非常に高速で信頼性の高いEXIF解析ライブラリ