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