Pexels Search Images MCP

MCP (Model Context Protocol) сервер для поиска изображений с использованием Pexels API. Позволяет искать и получать высококачественные фотографии по текстовому описанию.

Особенности

• 🔍 Поиск изображений через Pexels API
• 📝 Ограничение поискового запроса до 3 слов
• 🖼️ Возврат различных размеров изображений
• 📄 Поддержка пагинации
• ⚡ Быстрый и надежный поиск
• 🔧 TypeScript поддержка

Установка

Глобальная установка (рекомендуется)

npm install -g pexels-search-images-mcp

Локальная установка

npm install pexels-search-images-mcp

Настройка

1. Получите API ключ от Pexels
2. Установите переменную окружения:

export PEXELS_API_KEY="your_api_key_here"

Для Windows:

set PEXELS_API_KEY=your_api_key_here

Использование

Запуск через npx (npmjs)

npx pexels-search-images-mcp

Локальное тестирование без компиляции

# Установите зависимости
npm install

# Запустите с tsx
npx tsx src/index.ts

Конфигурация для MCP клиентов

Добавьте в конфигурацию вашего MCP клиента:

{
  "mcpServers": {
    "pexels-search-images": {
      "command": "npx",
      "args": ["pexels-search-images-mcp"],
      "env": {
        "PEXELS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Доступные инструменты

search_images

Поиск изображений по текстовому запросу.

Параметры:

• query (string, обязательный) - Поисковый запрос (максимум 3 слова)
• per_page (number, опциональный) - Количество изображений на странице (1-80, по умолчанию: 10)
• page (number, опциональный) - Номер страницы (по умолчанию: 1)

Пример использования:

{
  "name": "search_images",
  "arguments": {
    "query": "sunset beach",
    "per_page": 5,
    "page": 1
  }
}

Ответ:

{
  "total_results": 1000,
  "page": 1,
  "per_page": 5,
  "photos": [
    {
      "id": 123456,
      "width": 1920,
      "height": 1080,
      "photographer": "John Doe",
      "photographer_url": "https://www.pexels.com/@johndoe",
      "avg_color": "#FF6B6B",
      "url": "https://www.pexels.com/photo/...",
      "alt": "Beautiful sunset over the ocean",
      "src": {
        "original": "https://images.pexels.com/photos/.../original.jpeg",
        "large2x": "https://images.pexels.com/photos/.../large2x.jpeg",
        "large": "https://images.pexels.com/photos/.../large.jpeg",
        "medium": "https://images.pexels.com/photos/.../medium.jpeg",
        "small": "https://images.pexels.com/photos/.../small.jpeg",
        "portrait": "https://images.pexels.com/photos/.../portrait.jpeg",
        "landscape": "https://images.pexels.com/photos/.../landscape.jpeg",
        "tiny": "https://images.pexels.com/photos/.../tiny.jpeg"
      },
      "liked": false
    }
  ],
  "next_page": "https://api.pexels.com/v1/search/?page=2&per_page=5&query=sunset+beach"
}

Разработка

Установка зависимостей

npm install

Сборка

npm run build

Запуск в режиме разработки

npm run dev

Тестирование

# Установите переменную окружения
export PEXELS_API_KEY="your_api_key_here"

# Запустите сервер
npm run dev

Требования

• Node.js >= 18.0.0
• API ключ от Pexels

Ограничения

• Поисковый запрос должен содержать не более 3 слов
• Максимум 80 изображений на страницу
• Соблюдение лимитов API Pexels (200 запросов в час для бесплатного аккаунта)

Лицензия

MIT

Поддержка

Если у вас возникли проблемы или вопросы, создайте issue в GitHub репозитории.

Changelog

1.0.0

• Первоначальный релиз
• Базовая функциональность поиска изображений
• Поддержка пагинации
• Валидация поисковых запросов