Pexafy Stock Photos MCP Server已验证已精选

什么是 Pexafy Stock Photos MCP Server？

Pexafy Stock Photos MCP Server 是一个托管的 MCP 服务器，让 Claude、ChatGPT、Cursor、VS Code 等助手一次搜索来自 Unsplash、Pexels、Pixabay 等图库的数百万张可免费使用的照片，并返回附带许可和署名信息的真实照片。

Pexafy 搜索的是它自己的照片索引，这些照片收集自免费图库（据官网介绍共有九个免费许可来源），并按语义而非标签建立索引。你可以用任意语言用一句话描述场景，得到匹配的照片。在 ChatGPT、Claude、VS Code 和 Cursor 中，结果会以网格形式显示在对话里；在终端和代理中，每条结果以链接形式返回。服务器代码在 GitHub 上以 MIT 许可证开源。

如何使用 Pexafy Stock Photos MCP Server？

所有客户端使用同一个服务器 URL：https://mcp.pexafy.com/mcp，无需安装任何东西。在 Claude 和 ChatGPT 中，你只需在浏览器窗口中登录一次 Pexafy（OAuth；免费账户即可）。编辑器和编码代理无需账户即可立即搜索，但有每日额度限制；如需使用自己的账户和套餐额度，可以连接账户，或以 Bearer token 形式发送 MCP 类型的 Pexafy API key。

Claude Code

claude mcp add --transport http pexafy https://mcp.pexafy.com/mcp

如需使用你的 Pexafy key（在 Pexafy 后台创建 MCP 类型的 key）：

claude mcp add --transport http pexafy https://mcp.pexafy.com/mcp \
  --header "Authorization: Bearer YOUR_MCP_KEY"

用 claude mcp list 确认。还可以选择添加 Pexafy 技能，告诉代理何时以及如何使用这些工具：

npx skills add Pexafy/pexafy-mcp --skill find-stock-photos

Claude Desktop / claude.ai

打开 Customize → Connectors，点击 +，然后选择 Add custom connector。粘贴 https://mcp.pexafy.com/mcp，点击 Add，并在 Claude 打开的窗口中登录你的 Pexafy 账户。Pexafy 将 Claude 支持标注为预览版。

Cursor

在项目中创建 .cursor/mcp.json（或 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "pexafy": {
      "url": "https://mcp.pexafy.com/mcp"
    }
  }
}

如果要使用你的 key，Pexafy 文档给出了带 "headers": {"Authorization": "Bearer YOUR_MCP_KEY"} 字段的同样配置。

VS Code

运行 MCP: Add Server，或使用 README 中的单行命令：

code --add-mcp '{"name":"pexafy","type":"http","url":"https://mcp.pexafy.com/mcp"}'

然后在 Agent 模式下打开 Chat，在工具列表中选择 Pexafy。

其他客户端

ChatGPT 用户可以从插件目录添加 Pexafy。Codex 使用 codex mcp add pexafy --url https://mcp.pexafy.com/mcp。

Pexafy Stock Photos MCP Server 的主要功能

• 一次搜索即可覆盖 Unsplash、Pexels、Pixabay 及其他免费许可图库的照片。
• 语义搜索：用一整句话描述场景、氛围或光线，效果优于关键词，支持任意语言。
• 以图搜图：根据链接、上传的图片或之前的结果查找相似照片，还可以用文字调整（“like this, but at night”）。
• 每条结果都注明来源和许可，并附带需要展示的署名信息。
• 在支持的客户端中显示内嵌网格：每次请求返回十六张照片，提供喜欢、相似和下载操作；你选中的照片会按你选择的顺序交回给助手。
• 照片可以以图片文件形式返回（最大宽度 1280 px），用于文档、幻灯片或帖子。
• 全部五个工具均为只读；连接器无法写入你的账户。

Pexafy Stock Photos MCP Server 工具

• 搜索： search_photos 根据一句话描述查找照片，可限定横向、纵向或方形。search_photos_by_image 查找与参考图片或之前的 Pexafy 结果相似的照片。
• 文件与选择： get_photo_file_by_photo_id 把之前结果中的一张照片作为图片文件返回，并附带署名信息。get_grid_selected_photos 按你的顺序返回你在结果网格中点了心的照片。
• 账户： connect_account 请求宿主启动账户连接流程，适用于你需要超出无账户额度的搜索次数时。

Pexafy Stock Photos MCP Server 的使用场景

• 博客配图：“I'm writing a short article about Kyoto in autumn. Find photos of a temple garden with red maple leaves.”
• 落地页：“My landing page needs a hero image of a small team working in a bright office”，然后把选中的文件放进你的 HTML。
• 风格统一的组图：选中一张照片，要求“more like the second one”，为演示文稿构建风格一致的一组图片。
• 编码代理：让 Claude Code 获取照片文件，保存到你的仓库，并写好带署名的 Markdown。

Pexafy Stock Photos MCP Server 常见问题排查

• Claude Code 项目文件被拒绝： 在 .mcp.json 中，只有 url 而没有 "type": "http" 的条目会被拒绝；请补上 type。
• 无账户时达到搜索上限： 调用 connect_account 或让代理连接你的 Pexafy 账户，或以 Bearer header 添加 MCP 类型的 key。
• 没有出现网格： 网格只会在能绘制 MCP UI 的客户端（ChatGPT、Claude、VS Code、Cursor）中显示，其他客户端收到的是链接。
• Cursor 中看不到 Pexafy： 编辑 mcp.json 后重新打开 Cursor，并在侧边栏的 Customize 中查看。