Photo Organizer MCP

🚀 照片整理MCP服務器

由人工智能驅動，可對谷歌相冊和谷歌雲端硬盤進行整理。

此MCP服務器可讓Claude等人工智能代理自動整理您的谷歌相冊和雲端硬盤文件。非常適合清理雲存儲空間、查找重複文件以及維護有序的相冊。

🚀 快速開始

本服務器能借助人工智能，實現谷歌相冊和雲端硬盤文件的自動整理。下面將為你介紹它的安裝、配置和使用方法。

✨ 主要特性

谷歌相冊

• 📊 分析相冊庫：獲取您照片集的統計信息和洞察。
• 🔍 查找重複項：識別可能的重複照片。
• 📅 自動整理：按年或月創建相冊。
• 📈 生成報告：生成詳細的整理報告。

谷歌雲端硬盤

• 📂 自動整理：按文件類型（文檔、圖片、視頻等）將文件分類到文件夾中。
• 🗄️ 存檔舊文件：將舊文件移動到存檔文件夾。
• 🔄 去重：查找並刪除完全相同的重複文件。
• 📊 分析：獲取文件統計信息和存儲洞察。

📦 安裝指南

# 通過NPM安裝
npm install -g photo-organizer-mcp

# 或者克隆倉庫並構建
git clone https://github.com/ExpertVagabond/photo-organizer-mcp
cd photo-organizer-mcp
npm install
npm run build

📚 詳細文檔

1. 谷歌雲憑證

您需要谷歌雲憑證才能訪問相冊和雲端硬盤API：

1. 訪問 谷歌雲控制檯。
2. 創建一個新項目。
3. 啟用 谷歌相冊庫API 和 谷歌雲端硬盤API。
4. 創建OAuth 2.0憑證。
5. 下載 credentials.json 文件。

2. Python腳本

此MCP服務器對現有的Python整理腳本進行了封裝。設置路徑：

export PHOTO_SCRIPTS_PATH="/path/to/drive-photos-organizer"

或者添加到 .env 文件中：

PHOTO_SCRIPTS_PATH=/Users/yourname/drive-photos-organizer

3. 配置Claude桌面應用

添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "photo-organizer": {
      "command": "photo-organizer-mcp",
      "env": {
        "PHOTO_SCRIPTS_PATH": "/path/to/drive-photos-organizer"
      }
    }
  }
}

💻 使用示例

與Claude配合使用

“分析我的谷歌相冊並查找重複項”

Claude將使用analyze_photos工具掃描您的相冊庫

“按年份將我的照片整理到相冊中”

Claude將創建基於年份的相冊（先進行試運行，然後執行）

“通過將文件整理到文件夾中來清理我的谷歌雲端硬盤”

Claude將按文件類型將文件分類到有序的文件夾中

“將所有超過2年的雲端硬盤文件存檔”

Claude將把舊文件移動到存檔文件夾

“從我的雲端硬盤中查找並刪除重複文件”

Claude將識別並刪除完全相同的重複文件

可用工具

照片工具

1. analyze_photos - 獲取照片庫統計信息

{
  "findDuplicates": true
}

2. organize_photos_by_date - 創建基於日期的相冊

{
  "grouping": "year",  // 或者 "month"
  "execute": false     // 設置為true以實際創建相冊
}

雲端硬盤工具

3. analyze_drive - 獲取雲端硬盤統計信息

4. organize_drive - 將文件分類到文件夾中

{
  "execute": false  // 設置為true以實際進行整理
}

5. archive_old_files - 將舊文件移動到存檔文件夾

{
  "days": 730,      // 存檔超過此天數的文件
  "execute": false
}

6. deduplicate_drive - 刪除重複文件

{
  "execute": false  // 設置為true以實際刪除
}

🔧 技術細節

• 使用TypeScript和模型上下文協議SDK構建。
• 封裝Python腳本以實現谷歌API集成。
• 支持異步操作並提供進度報告。
• 可處理大型相冊庫（10,000張以上照片）。

📄 許可證

本項目採用MIT許可證，請參閱LICENSE文件獲取詳細信息。

👨‍💻 作者

ExpertVagabond - GitHub主頁

需要幫助？ 請聯繫：hello@expertvagabond.com