Flickr Mcp Server

Flickr MCP 服务

一个 MCP 服务，可让 AI 助手查看、描述、标记和管理你 Flickr 账户中的照片。浏览照片和相册，起草标题、描述和标签，查看统计数据，发现群组并投稿，阅读和发布评论，以及保存本地备注——这一切都通过 Model Context Protocol 完成。

前置条件

• Node.js 18+
• Flickr API 密钥（可在 flickr.com/services/apps/create/ 免费获取）
• 兼容 MCP 的客户端（Claude Desktop、Claude Code 等）

设置

1. 安装并构建

git clone https://github.com/soctib/flickr-mcp-server.git
cd flickr-mcp-server
npm install
npm run build

2. 获取 Flickr API 凭据

1. 前往 https://www.flickr.com/services/apps/create/
2. 创建一个新应用以获取你的 API Key（consumer key）和 Secret（consumer secret）

3. 通过 Flickr 授权

npm run setup-auth

此操作将：

• 提示你输入 API 密钥和 Secret（如果尚未保存在 .env 中）
• 打开浏览器窗口，让你在 Flickr 上授权此应用
• 自动将 OAuth 令牌保存到 .env

Flickr OAuth 令牌不会过期，因此只需执行一次。

4. 配置 MCP 客户端

将以下内容添加到 Claude Desktop 配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "flickr": {
      "command": "node",
      "args": ["/absolute/path/to/flickr-mcp-server/dist/index.js"],
      "env": {
        "FLICKR_CONSUMER_KEY": "your_key",
        "FLICKR_CONSUMER_SECRET": "your_secret",
        "FLICKR_OAUTH_TOKEN": "your_token",
        "FLICKR_OAUTH_TOKEN_SECRET": "your_token_secret"
      }
    }
  }
}

或者，将凭据保留在 .env 文件中，并省略 env 代码块。

可用工具

照片

工具	描述
flickr_get_recent_photos	列出你最近上传的照片及其元数据。可按可见性筛选（公开、私有、好友、家人）。
flickr_get_favorites	列出你收藏的照片及其元数据和所有者名称。
flickr_view_photo	获取照片图像和完整元数据。最多传入 10 个 ID，即可查看多张中等尺寸的照片。
flickr_view_thumbs	以 150px 方形缩略图查看多张照片。传入照片 ID，或传入相册 ID 以便直观浏览。
flickr_set_metadata	更新照片的标题和／或描述。
flickr_set_tags	替换照片上的所有标签。多个单词组成的标签必须加引号。

相册

工具	描述
flickr_list_albums	列出你的相册（或其他用户的公开相册），并显示照片数量和可见性标签。
flickr_get_album	获取指定相册中的照片及其完整元数据。

群组

工具	描述
flickr_list_groups	列出你加入的群组及其投稿限制。
flickr_search_groups	按主题搜索 Flickr 群组。
flickr_get_group_recents	浏览群组池中的近期照片，以评估群组活跃度和契合度。
flickr_get_photo_contexts	获取照片所属的所有群组和相册。传入照片 ID，或传入相册 ID 一次性检查其中的每张照片。
flickr_add_to_group	将照片提交到群组池。阻止提交私有照片。
flickr_remove_from_group	从群组池中移除照片。

统计数据与评论

工具	描述
flickr_get_activity	每日活动摘要：你整个账户的总浏览量，以及获得浏览、收藏和评论的照片。
flickr_get_stats	按浏览量／评论数／收藏数查看最受欢迎的照片，或查看指定照片的每日统计数据（最近 28 天）。
flickr_get_comments	阅读照片上的所有评论。
flickr_add_comment	在任意照片上发表评论。

本地备注

备注保存在本地 SQLite 数据库（notes.db）中，不会发送到 Flickr。可用它们记录提醒、想法、群组投稿计划或任何个人注释。

工具	描述
flickr_add_note	为照片、相册或群组添加备注。
flickr_get_notes	获取指定照片、相册或群组的所有备注。
flickr_delete_note	按 ID 删除备注。
flickr_search_notes	按文本内容搜索所有备注。

故障排除

• “OAuth signature invalid” — 重新运行 npm run setup-auth 以刷新令牌。
• “Authentication failed” — 检查 .env 中的 4 个凭据是否正确。
• 图片无法显示 — 服务将图片大小限制在约 700KB。过大的照片会改为仅显示文本，并附带 Flickr URL。
• 统计数据为空 — photo_daily 模式仅涵盖最近 28 天（Flickr 的限制）。如需查看历史总数，请使用 popular 模式。
• 添加到群组时提示“Not a member” — 必须先在 Flickr 网站上加入该群组。
• better-sqlite3 版本不匹配 — 如果服务启动时因 NODE_MODULE_VERSION 错误而崩溃，请使用运行服务的同一 Node 版本运行 npm rebuild better-sqlite3。

开发

npm run build          # Compile TypeScript
npm start              # Run the server (stdio)
npm run setup-auth     # Re-run OAuth setup

使用 MCP Inspector 进行测试：

npx @modelcontextprotocol/inspector node dist/index.js

免责声明

本项目由 Claude 通过氛围编程编写。项目可以运行，也经过了测试，但请合理调整预期。

许可证

MIT