FindMe Photo

本地服务

findme.photo文件与存储018 周前更新

代码仓库访问官网

关于 FindMe Photo

FindMe Photo MCP 服务让摄影师和活动组织者通过 AI 客户端管理婚礼照片图库。它支持创建和维护活动、上传照片、生成图库二维码及查看访客分析。

主要功能

01创建、列出和管理活动图库
02从本地路径或公开 URL 上传照片
03从 Google Drive 导入照片
04生成公开图库二维码
05查看访客、下载和自拍搜索分析

适用场景

01为婚礼创建照片图库并批量上传照片
02更新活动日期或访问码
03生成二维码分享公开图库
04查看访客、下载和自拍搜索数据

MCP 相关

FindMe Photo MCP 服务向兼容的 AI 客户端提供 12 个图库管理、照片上传、二维码和分析工具；服务在客户端所在机器本地运行。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "findmephoto-findme": {
      "command": "npx",
      "args": [
        "-y",
        "findme-mcp"
      ],
      "env": {
        "FINDME_API_KEY": "<FINDME_API_KEY>"
      }
    }
  }
}

启动命令npx -y findme-mcp

需要配置的环境变量

FINDME_API_KEY密钥Personal API key from https://findme.photo/settings/api (starts with fm_live_)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmfindme-mcp0.7.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

FindMe Photo MCP 服务

适用于 FindMe Photo（AI 驱动的婚礼相册平台）的官方模型上下文协议服务。

通过 Claude、ChatGPT Codex、Cursor 以及任何其他兼容 MCP 的 AI 客户端管理 FindMe 相册。创建活动、上传照片、查看分析数据——全部通过自然语言完成。

功能

“为 4 月 22 日的 Sarah 和 Mike 婚礼创建一个 FindMe 活动，将 ~/Pictures/Sarah-Mike 中的所有照片上传到该活动，然后给我看看二维码。”

AI 使用此 MCP 服务，一轮对话即可完成全部三个步骤。

工具

工具	用途
`create_event`	创建新相册。
`list_events`	列出你的活动（分页）。
`get_event`	获取活动详情和统计数据。
`update_event`	重命名、修改日期或更改访问码。
`delete_event`	软删除，可在 7 天内恢复。
`restore_event`	在 7 天内恢复已删除的活动。
`upload_photos_from_paths`	上传本地文件或文件夹。主要上传工具。
`upload_photos_from_urls`	从公开 URL 上传（Dropbox、Google Drive 直链等）。
`upload_photos_from_drive_folder`	从 Google Drive 导入（v1 中仅部分支持）。
`get_event_qr`	获取指向公开相册的 PNG 二维码。
`get_event_analytics`	查看访客访问量、独立访客数、下载量和自拍搜索次数。
`get_usage`	查看当月 API 用量、存储用量和活动总数。

要求

Node.js 18+
FindMe Photo Free+、Growth 或 Pro 账户
在 https://findme.photo/settings/api 获取个人 API 密钥

安装

最简单的方法：让 AI 自行安装。 粘贴提示词，AI 会编辑自己的配置，无需创建隐藏文件。

面向非技术背景摄影师的分步指南，请参阅完整安装指南。

Claude Desktop

打开 Claude Desktop，点击 Code 标签页（而不是 Chat），然后粘贴以下提示词（替换密钥）：

Install the FindMe MCP server for me.

- Server name: findme
- Command: npx
- Args: -y findme-mcp
- Env var: FINDME_API_KEY = fm_live_PASTE_YOUR_KEY_HERE

Edit my claude_desktop_config.json under mcpServers, then tell me to fully quit and reopen Claude.

Claude Code（CLI）

claude mcp add findme --scope user --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcp

ChatGPT Codex

codex mcp add findme --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcp

Cursor / Windsurf / VS Code / Cline

使用工具内置的 MCP 安装界面，并填写：

命令：npx
参数：-y findme-mcp
环境变量：FINDME_API_KEY=fm_live_xxxxx

ChatGPT 网页版 / 移动版

即将推出——需要托管的 MCP 端点。我们即将发布 mcp.findme.photo。目前请使用 Claude Desktop 或 Codex。

其他任何 MCP 客户端

FINDME_API_KEY=fm_live_xxxxx npx findme-mcp

验证

重启后，你应该能在客户端的工具列表中看到 findme（12 个工具）。试试：

创建一个名为“My First Gallery”、日期为今天的 FindMe 活动，然后给我看看二维码。

故障排除

“MCP server failed to start”

确保 Node.js 版本为 18+：node --version
首次运行时会通过 npx 下载软件包；请允许其通过防火墙
如果你手动编辑过配置，请检查 JSON 是否有效（末尾不能有逗号）

“Your FindMe API key is invalid or has been revoked”

在 https://findme.photo/settings/api 生成新密钥
粘贴完整密钥，包括 fm_live_ 前缀
完全退出并重启 AI 客户端

“API access requires Free+, Growth, or Pro”

API 访问是付费套餐功能。请前往 https://findme.photo/pricing 升级。

在 macOS 上上传时提示 “can't find folder”

这是 macOS 的隐私保护机制。打开 System Settings → Privacy & Security → Full Disk Access，并添加你的 AI 客户端（Claude Desktop、Terminal 等）。然后退出并重新打开客户端。

上传部分失败

单个文件出错不会导致整个批次失败——工具会返回摘要，显示哪些文件上传成功、哪些失败。请让 AI 专门重试失败的文件。

限制

套餐	速率限制	月度配额
Free+	10 次请求/分钟	500 次/月
Growth	60 次请求/分钟	10,000 次/月
Pro	300 次请求/分钟	不限

单个文件限制：照片 50 MB，视频 500 MB；每批最多上传 50 个文件。

v1 局限

upload_photos_from_drive_folder 需要通过 findme.photo 网页界面创建现有的 Drive 导入；MCP 可以轮询状态，但目前无法创建导入。
MCP 在与你的 AI 客户端相同的机器上本地运行；它只能查看该机器上的文件。

资源

许可证

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。