photo-organizer

Photo Organizer MCP Server

为 Google Photos 和 Google Drive 提供 AI 驱动的整理功能。

此 MCP 服务可让 Claude 等 AI Agent 自动整理你的 Google Photos 和 Google 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 凭据

你需要 Google Cloud 凭据才能访问 Photos 和 Drive API：

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 构建
• 封装 Python 脚本以集成 Google API
• 异步操作并报告进度
• 支持大型媒体库（10,000 张以上照片）

贡献

欢迎贡献！请在 GitHub 上提交问题或 PR。

许可证

MIT License - 详见 LICENSE 文件

作者

ExpertVagabond - https://github.com/ExpertVagabond

---

需要帮助？ 联系方式：[email protected]