AI导哈

Pexels媒体访问服务

一个提供Pexels API访问的模型上下文协议服务器，允许AI模型搜索和检索Pexels的照片、视频和收藏。

  • by CaullenOmdahl
  • TypeScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 CaullenOmdahl/pexels-mcp-server

使用说明

Pexels MCP服务器

模型上下文协议（MCP）服务器，提供对Pexels API的访问，允许AI模型从Pexels搜索和检索照片、视频和收藏。

特性

  • 按查询、方向、大小和颜色搜索照片和视频
  • 访问Pexels的精选和流行内容
  • 浏览Pexels系列
  • 获取特定照片和视频的详细信息
  • 通过工具或直接URI资源访问内容

需求

地方发展

  1. 克隆存储库
  2. 安装依赖项
    pnpm install
  3. 构建项目
    pnpm build
  4. 以开发模式运行
    PEXELS_API_KEY=your_api_key pnpm dev

部署到Smithery

此MCP服务器已准备好部署到Smithery。请按照以下步骤操作：

  1. 将服务器添加到Smithery或声明现有服务器
  2. 转到“部署”选项卡（仅对经过身份验证的所有者可见）
  3. 部署服务器
  4. 配置部署时，请在配置设置中提供Pexels API密钥

API使用

服务器提供以下工具：

照片工具

  • searchPhotos：通过查询搜索照片（使用描述性关键字获取相关结果，例如“泰国酒店接待”、“红色跑车驾驶”，而不仅仅是“酒店”或“汽车”；结合以下参数 orientation, size, color，以及 locale 用于优化结果），可选择方向、大小、颜色、区域设置（例如“en-US”、“es-es”）、页面和每页结果的过滤器。返回元数据，包括照片ID和URL，以及当前API速率限制状态。
  • downloadPhoto：按ID和所需大小获取特定照片（可选，默认为“原始”）。可用尺寸：“原始”、“大2x”、“大型”、“中型”、“小型”、“纵向”、“横向”、“微型”。返回请求的图像大小、建议的文件名（包括大小）和归因信息的直接下载链接。AI客户端应使用其可用的本地工具（如 curl 或PowerShell Invoke-WebRequest)使用提供的链接下载照片。
  • getCuratedPhotos：从Pexels检索一组经过精心策划的照片，可以选择分页。
  • getPhoto：通过ID检索特定照片的详细信息。

视频工具

  • searchVideos：通过查询搜索视频（使用描述性关键字获取相关结果，例如“无人机拍摄的海滩日落”、“延时城市交通”，而不仅仅是“海滩”或“城市”；结合以下参数 orientation 和 size 用于优化结果），可选择方向、大小、区域设置（例如“en-US”、“es-es”）、页面和每页结果的过滤器。返回元数据，包括视频ID和URL，以及当前API速率限制状态。
  • getPopularVideos：从Pexels中检索热门视频列表，并使用可选的维度、持续时间、页面和每页结果过滤器。
  • getVideo：通过ID检索特定视频的详细信息。
  • downloadVideo：通过ID和首选质量（hd/sd）获取特定视频。返回直接下载链接、建议的文件名和归因信息。AI客户端应使用其可用的本地工具（如 curl 或PowerShell Invoke-WebRequest)使用提供的链接下载视频。

收藏工具

  • getFeaturedCollections：从Pexels检索特色收藏列表，可选择分页。
  • getMyCollections：（在代码中注释）需要OAuth 2.0身份验证，此服务器不支持。
  • getCollectionMedia：按收藏ID从特定收藏中检索媒体项目（照片或视频），可选的过滤器包括类型、排序顺序、页面和每页结果。

资源

服务器提供以下URI可寻址资源：

  • pexels-photo://{id}：通过ID访问特定照片
  • pexels-video://{id}：通过ID访问特定视频
  • pexels-collection://{id}：按ID访问特定集合

错误处理

服务器尝试为常见问题（如API密钥无效、速率限制或资源丢失）提供信息性错误消息。成功的响应还包括输出中的当前Pexels API速率限制状态（剩余请求、重置时间）。

归因要求

使用Pexels API时，您必须遵循其归因要求：

  • 始终显示指向Pexels的突出链接（例如，“Pexels提供的照片”）
  • 始终归功于摄影师（例如，“John Doe在Pexels上的照片”）

许可证

国际协调委员会

相关 MCP