photo-organizer

Photo Organizer MCP サーバー

Google Photos と Google Drive を AI で整理します。

この MCP サーバーを使うと、Claude などの AI エージェントが Google Photos と Drive のファイルを自動で整理できます。クラウドストレージの整理、重複ファイルの検索、写真アルバムの整頓に最適です。

機能

Google Photos

• 📊 ライブラリを分析：写真コレクションの統計情報と分析結果を取得します
• 🔍 重複を検索：重複している可能性のある写真を特定します
• 📅 自動整理：年別または月別にアルバムを作成します
• 📈 レポート：詳細な整理レポートを生成します

Google Drive

• 📂 自動整理：種類（ドキュメント、画像、動画など）ごとにファイルをフォルダーへ振り分けます
• 🗄️ 古いファイルをアーカイブ：古いファイルを Archive フォルダーへ移動します
• 🔄 重複を削除：完全に重複したファイルを検索して削除します
• 📊 分析：ファイルの統計情報とストレージの分析結果を取得します

インストール

# Install from NPM
npm install -g photo-organizer-mcp

# Or clone and build
git clone https://github.com/ExpertVagabond/photo-organizer-mcp
cd photo-organizer-mcp
npm install
npm run build

セットアップ

1. Google Cloud の認証情報

Photos と Drive の API にアクセスするには、Google Cloud の認証情報が必要です。

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成します
3. Google Photos Library API と Google Drive 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 Desktop を設定する

claude_desktop_config.json に追加します。

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

使用例

Claude で使用する

「Google Photos を分析して、重複した写真を見つけて」

Claude will use the analyze_photos tool to scan your library

「写真を年別のアルバムに整理して」

Claude will create year-based albums (dry run first, then execute)

「Google Drive のファイルをフォルダーに整理して、すっきりさせて」

Claude will sort files by type into organized folders

「2 年以上前の Drive ファイルをすべてアーカイブして」

Claude will move old files to an Archive folder

「Drive から重複ファイルを見つけて削除して」

Claude will identify and remove exact duplicates

利用可能なツール

写真ツール

1. analyze_photos - 写真ライブラリの統計情報を取得します

   {
     "findDuplicates": true
   }
   

2. organize_photos_by_date - 日付別のアルバムを作成します

   {
     "grouping": "year",  // or "month"
     "execute": false     // true to actually create albums
   }
   

Drive ツール

3. analyze_drive - Drive の統計情報を取得します

4. organize_drive - ファイルをフォルダーへ振り分けます

   {
     "execute": false  // true to actually organize
   }
   

5. archive_old_files - 古いファイルを Archive へ移動します

   {
     "days": 730,      // Archive files older than this
     "execute": false
   }
   

6. deduplicate_drive - 重複ファイルを削除します

   {
     "execute": false  // true to actually delete
   }
   

安全機能

• デフォルトでドライラン：すべての操作は、デフォルトでドライランモードになります
• 明示的な実行：変更を加えるには、execute: true を設定する必要があります
• 詳細なレポート：実行前に、何が行われるかを正確に確認できます
• 非破壊的：整理とアーカイブを行い、削除はしません（重複削除を除く）

収益化（Pro 版）

高度な機能を利用するにはアップグレードしてください。

無料プラン

• 月 50 回の操作
• 基本的な整理
• 手動での実行が必要

Pro（$10/月）

• 操作回数無制限
• スケジュール設定による自動整理
• 高度な重複検出
• 優先サポート

Enterprise（$50/月）

• ホワイトラベルのブランディング
• チーム管理
• カスタムルールエンジン
• API アクセス

技術的な詳細

• TypeScript と Model Context Protocol SDK で構築
• Google API との連携に Python スクリプトを使用
• 進行状況を報告する非同期処理
• 大規模なライブラリ（写真 10,000 枚以上）に対応

貢献

貢献を歓迎します！GitHub で Issue または PR を作成してください。

ライセンス

MIT License - LICENSE file を参照してください

作成者

ExpertVagabond - https://github.com/ExpertVagabond

---

お困りですか？ お問い合わせ先：[email protected]