Pexels API에 액세스 할 수있는 모델 Context Protocol (MCP) 서버는 Pexels의 사진, 비디오 및 컬렉션을 검색하고 검색 할 수있는 AI 모델을 허용한다.

특징

• 쿼리, 오리엔테이션, 크기 및 색상으로 사진 및 동영상 검색
• Pexels의 액세스 curated 및 인기있는 내용
• Browse Pexels 컬렉션
• 특정 사진 및 동영상에 대한 자세한 정보를 얻으십시오.
• 도구 또는 직접 URI 리소스를 통한 액세스 콘텐츠

요구 사항

• Node.js 18 이상
• Pexels API 키 ( https://www.pexels.com/api/)에서 하나씩 추가)

지역 개발

1. 저장소를 복제

2. 의존성 설치

3. 프로젝트 구축

4. 개발 모드에서 실행

Smithery에 배포

이 MCP 서버는 Smithery에 배포 할 준비가되어 있습니다. 이 단계를 따르십시오:

1. Smithery에 서버를 추가하거나 기존 서버 주장
2. Deployments 탭으로 이동 (통합된 소유자에서만 볼 수 있음)
3. 서버 배포
4. 배포를 구성하면 구성 설정에서 Pexels API 키를 제공합니다.

API 사용

서버는 다음과 같은 도구를 제공합니다:

# 사진 도구

• searchPhotos: Search for photos by query (관련 결과에 대한 descriptive 키워드 사용, 예를 들어.

Pexels MCP Server

A Model Context Protocol (MCP) server that provides access to the Pexels API, allowing AI models to search for and retrieve photos, videos, and collections from Pexels.

Features

• Search for photos and videos by query, orientation, size, and color
• Access curated and popular content from Pexels
• Browse Pexels collections
• Get detailed information about specific photos and videos
• Access content via tools or direct URI resources

Requirements

• Node.js 18 or higher
• A Pexels API key (get one at https://www.pexels.com/api/)

Local Development

1. Clone the repository
2. Install dependencies

   pnpm install
   

3. Build the project

   pnpm build
   

4. Run in development mode

   PEXELS_API_KEY=your_api_key pnpm dev
   

Deploying to Smithery

This MCP server is ready to be deployed to Smithery. Follow these steps:

1. Add the server to Smithery or claim an existing server
2. Go to the Deployments tab (only visible to authenticated owners)
3. Deploy the server
4. When configuring the deployment, provide your Pexels API key in the configuration settings

API Usage

The server provides the following tools:

Photo Tools

• searchPhotos: Search for photos by query (use descriptive keywords for relevant results, e.g., ‘Thai hotel reception’, ‘red sports car driving’, not just ‘hotel’ or ‘car’; combine with parameters like orientation, size, color, and locale for refined results), with optional filters for orientation, size, color, locale (e.g., ‘en-US’, ‘es-ES’), page, and results per page. Returns metadata including photo IDs and URLs, plus current API rate limit status.
• downloadPhoto: Fetches a specific photo by its ID and desired size (optional, defaults to ‘original’). Available sizes: ‘original’, ‘large2x’, ‘large’, ‘medium’, ‘small’, ‘portrait’, ‘landscape’, ‘tiny’. Returns a direct download link for the requested image size, suggested filename (including size), and attribution information. The AI client should use its available local tools (like curl or PowerShell’s Invoke-WebRequest) to download the photo using the provided link.
• getCuratedPhotos: Retrieve a curated set of photos from Pexels, optionally paginated.
• getPhoto: Retrieve detailed information about a specific photo by its ID.

Video Tools

• searchVideos: Search for videos by query (use descriptive keywords for relevant results, e.g., ‘drone footage beach sunset’, ‘time lapse city traffic’, not just ‘beach’ or ‘city’; combine with parameters like orientation and size for refined results), with optional filters for orientation, size, locale (e.g., ‘en-US’, ‘es-ES’), page, and results per page. Returns metadata including video IDs and URLs, plus current API rate limit status.