Pexels MCP Server

这是一个模型上下文协议（MCP）服务器，提供对Pexels API的访问，允许AI模型搜索并检索来自Pexels的照片、视频和集合。

功能

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

要求

• Node.js 18或更高版本
• 一个Pexels API密钥（在https://www.pexels.com/api/获取）

本地开发

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和所需大小下载特定照片（可选，默认为'original'）。可用大小：'original'、'large2x'、'large'、'medium'、'small'、'portrait'、'landscape'、'tiny'。返回请求图像大小的直接下载链接，建议文件名（包括大小）和归属信息。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访问特定照片
• p-exels-video://{id}: 根据ID访问特定视频
• pexels-collection://{id}: 根据ID访问特定集合

错误处理

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

归属要求

使用Pexels API时，必须遵循他们的归属要求：

• 总是显示一个显眼的链接到Pexels（例如，“照片由Pexels提供”）
• 总是给摄影师署名（例如，“John Doe在Pexels上的照片”）

许可证

ISC