Photo Organizer MCP

🚀 フォトオーガナイザーMCPサーバー

GoogleフォトとGoogleドライブのAIによる整理機能を提供します。

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

✨ 主な機能

Googleフォト

• 📊 ライブラリの分析：写真コレクションに関する統計情報と洞察を取得します。
• 🔍 重複写真の検索：潜在的な重複写真を特定します。
• 📅 自動整理：年または月ごとにアルバムを作成します。
• 📈 レポート：詳細な整理レポートを生成します。

Googleドライブ

• 📂 自動整理：ファイルをタイプ（文書、画像、動画など）ごとにフォルダに分類します。
• 🗄️ 古いファイルのアーカイブ：古いファイルをアーカイブフォルダに移動します。
• 🔄 重複排除：完全に重複するファイルを検索して削除します。
• 📊 分析：ファイルの統計情報とストレージの洞察を取得します。

📦 インストール

# 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. 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フォトを分析して重複写真を見つける」

Claudeはanalyze_photosツールを使用してライブラリをスキャンします。

「写真を年ごとのアルバムに整理する」

Claudeは年ごとのアルバムを作成します（まずドライラン、その後実行）。

「Googleドライブを整理してファイルをフォルダに分類する」

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に設定
   }
   

⚠️ 安全機能

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

💰 有料版（Proバージョン）

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

無料版

• 月あたり50回の操作
• 基本的な整理機能
• 手動実行が必要

Pro（月額10ドル）

• 無制限の操作
• スケジュールされた自動整理
• 高度な重複検出
• 優先サポート

エンタープライズ（月額50ドル）

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

🔧 技術詳細

• TypeScriptとModel Context Protocol SDKを使用して構築されています。
• Google APIとの統合にPythonスクリプトをラップしています。
• 進行状況報告付きの非同期操作
• 大規模なライブラリ（10,000枚以上の写真）を処理できます。

🤝 コントリビューション

コントリビューションを歓迎します！GitHubでイシューまたはプルリクエストを開いてください。

📄 ライセンス

MITライセンス - LICENSEファイルを参照してください。

👤 作者

ExpertVagabond - https://github.com/ExpertVagabond

ヘルプが必要ですか？ お問い合わせ：hello@expertvagabond.com