EXIF Metadata

🚀 exif-mcp

exif-mcp 是一款 MCP 服務器，可讓大語言模型（或人類用戶）在完全離線的狀態下，按需讀取圖像元數據。它依託出色的 exifr 庫，運行速度極快，且無需依賴任何外部工具。

🚀 快速開始

exif-mcp 是一個模型上下文協議（MCP）服務器，提供多種工具以提取圖像的各種元數據段。該工具使用 TypeScript 編寫，並藉助出色的 exifr 庫解析常見格式如 JPEG、PNG、TIFF 和 HEIC 的圖像元數據。這使得該服務能夠在不執行任何外部工具的情況下解析圖像元數據，從而實現高效且可靠。

✨ 主要特性

• 離線讀取：允許大語言模型或人類在完全脫機的情況下按需讀取圖像元數據。
• 高速運行：基於 exifr 庫，運行速度極快。
• 獨立性強：不依賴任何外部工具。
• 功能豐富：提供多種工具提取圖像不同類型的元數據。
• 多方式加載：支持文件路徑、網絡 URL、Base64 字符串和 Buffer 對象四種圖像加載方式。
• 錯誤處理：提供針對常見問題的標準錯誤處理機制。

使用場景

• 分析圖像元數據並進行可視化。
• 對您的圖像庫進行分析：瞭解最常用的相機、鏡頭分佈、拍照最多的時間、最喜歡去的地點等。
• 調試圖像處理代碼。

此工具被用於開發和測試反向地理定位服務 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 支持以下四種圖像加載方式：

1. 文件路徑
2. 網絡 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 解析庫