Photo Organizer MCP

照片管理器MCP服务器

谷歌照片和谷歌云端硬盘的人工智能驱动组织。

此MCP服务器使像Claude这样的AI代理能够自动组织您的Google照片和驱动器文件。非常适合整理云存储、查找副本和维护有组织的相册。

特性

谷歌照片

• 📊 分析库：获取有关您的照片收藏的统计数据和见解
• 🔍 参考文献查重：识别潜在的重复照片
• 📅 自动组织：按年份或月份创建相册
• 📈 报告：生成详细的组织报告

Google 云端硬盘

• 📂 自动组织：按类型将文件排序到文件夹中（文档、图像、视频等）
• 🗄️ 存档旧文件：将旧文件移动到存档文件夹
• 🔄 去重：查找并删除完全重复的文件
• 📊 分析：获取文件统计数据和存储见解

安装

# 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凭据才能访问照片和驱动器API：

1. 首选 Google 云控制台
2. 创建一个新项目
3. 启用 谷歌照片库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_config.json:

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

使用示例

与克劳德

“分析我的谷歌照片并查找重复项”

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年的驱动器文件”

Claude will move old files to an Archive folder

“查找并删除我的驱动器中的重复文件”

Claude will identify and remove exact duplicates

可用工具

照片工具

1. 分析照片 -获取照片库统计信息

   {
     "findDuplicates": true
   }

1. 组织_照片_按日期 -创建基于日期的相册

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

驱动工具

1. 分析驱动 -获取驱动器统计信息

1. 组织驱动 -将文件排序到文件夹中

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

1. 归档文件 -将旧文件移动到存档

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

1. 重复数据消除驱动器 -删除重复文件

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

安全特性

• 默认情况下进行试运行：所有操作默认为干运行模式
• 显式执行：必须设置 execute: true 改变
• 详细报告：在执行之前，看看会发生什么
• 无损检测：组织和存档，不删除（重复数据消除除外）

货币化（专业版）

升级以获得高级功能：

免费套餐

• 每月50次操作
• 基本组织
• 需要手动执行

专业版（每月10美元）

• 无限制操作
• 计划汽车组织
• 高级重复检测
• 优先支持

企业（每月50美元）

• 白标品牌
• 团队管理
• 自定义规则引擎
• API访问

技术细节

• 使用TypeScript和模型上下文协议SDK构建
• 为Google API集成打包Python脚本
• 与进度报告异步操作
• 处理大型图书馆（10000+张照片）

贡献

欢迎投稿！请在GitHub上打开问题或PR。

许可证

MIT许可证-请参阅许可证文件

作者

ExpertVagabond-https://github.com/ExpertVagabond

______________________________________________________________________

需要帮助？ 联系人：hello@expertvagabond.com