亚马逊照片管理服务器

一个封装非官方Amazon Photos Python库的FastMCP服务器,提供照片和视频的管理、搜索、上传和下载功能。

  • by kpfitzgerald
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kpfitzgerald/amazon-photos-mcp

使用说明

亚马逊照片MCP服务器

FastMCP服务器包装非官方 亚马逊照片 Python库(MIT许可证)。

设置

1.获取您的亚马逊Cookie

  1. 打开https://www.amazon.com/photos在Chrome浏览器中
  2. 登录您的亚马逊帐户
  3. 打开DevTools(F12)>应用程序>Cookie>amazon.com
  4. 复制这三个值:
    • ubid_main
    • at_main
    • session-id

2.保存Cookie

运行安装帮助程序:

~/amazon-photos-mcp/setup-cookies.sh

或手动创建 ~/.config/amazon-photos-mcp/cookies.json:

{
  "ubid_main": "your-value-here",
  "at_main": "your-value-here",
  "session-id": "your-value-here"
}

3.用克劳德代码注册

claude mcp add amazon-photos -- uvx --from ~/amazon-photos-mcp amazon-photos-mcp

工具(15)

工具 说明
check_connection 测试API访问并获取存储使用情况
search_photos 使用查询过滤器(事物、日期、地点)进行搜索
get_photos 获取最新照片
get_videos 获取最新视频
get_storage_usage 存储计划和使用统计数据
get_aggregations 自动检测标签(人、事物、地点)
list_folders 列出所有文件夹
get_folder_tree 显示文件夹层次结构
search_by_date 按年/月/日搜索
search_by_things 根据检测到的物体(海滩、狗等)进行搜索
trash_items 将物品移至垃圾箱
list_trashed 查看垃圾箱内容
restore_items 从回收站还原
upload_file 上传文件
download_files 按节点ID下载

验证注释

  • 使用基于cookie的身份验证(不是OAuth)——cookie过期并需要定期刷新
  • Cookie存储在 ~/.config/amazon-photos-mcp/cookies.json (600克)
  • 这是一个非官方的API-如果亚马逊改变其前端,可能会中断