用途:通过 Rube MCP(Composio)在 Google Photos 中自动化上传照片、管理相册、搜索媒体与批量整理内容。工具包文档见 composio.dev/toolkits/googlephotos。
前置条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 建立 googlephotos 工具包的有效连接;每次先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。
设置:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定工具包 googlephotos;若连接非 ACTIVE,按返回的授权链接完成设置;确认状态为 ACTIVE 后再运行工作流。
主要能力:GOOGLEPHOTOS_LIST_ALBUMS 列出相册(pageSize、pageToken、excludeNonAppCreatedData);GOOGLEPHOTOS_CREATE_ALBUM 创建相册(title 必填);GOOGLEPHOTOS_UPLOAD_MEDIA 上传图片或视频(file_to_upload 或 url、file_name、description);GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS 批量上传并创建媒体项(files、urls、media_files、albumId、albumPosition);GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS 搜索媒体(albumId、filters、orderBy、pageSize、pageToken);GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS 将已有媒体项加入相册(albumId、mediaItemIds 必填);另有 GET_ALBUM、UPDATE_ALBUM、ADD_ENRICHMENT 等。
常见模式:先创建相册再用 albumId 批量上传;先搜索或列出媒体项获取 ID 再批量加入相册;更新相册标题或封面;获取相册详情;添加文字叠加、位置或地图增强;通过 url 参数直接从网页 URL 上传。
限制与注意:GOOGLEPHOTOS_LIST_MEDIA_ITEMS 已弃用,建议改用 SEARCH_MEDIA_ITEMS;上传图片上限 200MB,视频有更大限制,超出会失败;相册 ID 为不透明字符串,须从 LIST_ALBUMS 或 CREATE_ALBUM 响应获取;BATCH_ADD_MEDIA_ITEMS 只能向本应用创建或用户拥有的相册添加项目;filters 使用特定 Google Photos API 过滤结构,需查阅架构了解日期范围与内容类别格式;通过 API 创建的媒体项可能因处理延迟不会立即出现在网页界面。