# Stock Images MCP

Ищет и сохраняет бесплатные стоковые фотографии с Pexels, Unsplash и Pixabay прямо через чат с ассистентом. Пригодится при сборке макетов, статей и интерфейсов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: jeanpfs
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jeanpfs/stock-images-mcp
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/stock-images-mcp

## Что делает

Сервер даёт агенту два инструмента: `search_images` для поиска по базам стоков и `download_image` для сохранения файлов на диск. Поиск можно ограничить конкретным сервисом или запустить сразу по всем настроенным источникам. Доступна фильтрация по альбомной или портретной ориентации. В ответе приходят размеры, ссылка на превью, адрес скачивания и данные фотографа для указания авторства.

Загрузка защищена от типовых проблем с файловой системой. Скрипт принимает только ответы с типом `image/*`, ограничивает размер файла лимитом 50 МиБ и отсекает запросы дольше 30 секунд. Все файлы отправляются в папку `./downloads` или каталог из переменной `STOCK_IMAGES_DOWNLOAD_DIR`. Попытки выйти за пределы разрешённого каталога через симлинки сервер блокирует, а существующие файлы никогда не перезаписывает.

Для запуска нужен Node.js 22 или новее. Также потребуется ключ хотя бы для одного сервиса: Pexels, Unsplash или Pixabay. Без ключа соответствующий сервис работать не будет.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `PEXELS_API_KEY`, `UNSPLASH_API_KEY`, `PIXABAY_API_KEY`, `STOCK_IMAGES_DOWNLOAD_DIR` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env PEXELS_API_KEY=<PEXELS_API_KEY> --env UNSPLASH_API_KEY=<UNSPLASH_API_KEY> --env PIXABAY_API_KEY=<PIXABAY_API_KEY> --env STOCK_IMAGES_DOWNLOAD_DIR=<STOCK_IMAGES_DOWNLOAD_DIR> --transport stdio stock-images-mcp -- npx -y stock-images-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add stock-images-mcp --env PEXELS_API_KEY=<PEXELS_API_KEY> --env UNSPLASH_API_KEY=<UNSPLASH_API_KEY> --env PIXABAY_API_KEY=<PIXABAY_API_KEY> --env STOCK_IMAGES_DOWNLOAD_DIR=<STOCK_IMAGES_DOWNLOAD_DIR> -- npx -y stock-images-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "stock-images-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "stock-images-mcp"
            ],
            "env": {
                "PEXELS_API_KEY": "<PEXELS_API_KEY>",
                "UNSPLASH_API_KEY": "<UNSPLASH_API_KEY>",
                "PIXABAY_API_KEY": "<PIXABAY_API_KEY>",
                "STOCK_IMAGES_DOWNLOAD_DIR": "<STOCK_IMAGES_DOWNLOAD_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "stock-images-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "stock-images-mcp"
            ],
            "env": {
                "PEXELS_API_KEY": "<PEXELS_API_KEY>",
                "UNSPLASH_API_KEY": "<UNSPLASH_API_KEY>",
                "PIXABAY_API_KEY": "<PIXABAY_API_KEY>",
                "STOCK_IMAGES_DOWNLOAD_DIR": "<STOCK_IMAGES_DOWNLOAD_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e PEXELS_API_KEY=<PEXELS_API_KEY> -e UNSPLASH_API_KEY=<UNSPLASH_API_KEY> -e PIXABAY_API_KEY=<PIXABAY_API_KEY> -e STOCK_IMAGES_DOWNLOAD_DIR=<STOCK_IMAGES_DOWNLOAD_DIR> stock-images-mcp npx -y stock-images-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- найти стоковые фотографии под интерфейс или статью через диалог с агентом
- скачать изображения в папку проекта без ручного перехода в браузер
- сохранить имя автора и ссылку на профиль для выполнения условий лицензии
- отфильтровать снимки по вертикальной или горизонтальной ориентации

## Примеры запросов агенту
- Найди пять фотографий современного офиса в альбомной ориентации на Unsplash и покажи авторов.
- Поищи на Pexels портретные снимки разработчиков и скачай лучший вариант в папку downloads.
- Скачай изображение по ссылке из Pixabay и сохрани его под именем banner.jpg.

## Похожие
- [Next AI Draw.io](https://affpapa.org/nevibecode/mcp/next-ai-drawio.md) — MCP-сервер · ★ 36427
- [tldraw](https://affpapa.org/nevibecode/mcp/tldraw.md) — MCP-сервер · ★ 51104
- [Figma-Context-MCP](https://affpapa.org/nevibecode/mcp/figma-context-mcp.md) — MCP-сервер · ★ 16073
- [Agent-Native Assets](https://affpapa.org/nevibecode/mcp/agent-native-assets.md) — MCP-сервер · ★ 7527
- [Remove AI Watermarks](https://affpapa.org/nevibecode/mcp/remove-ai-watermarks.md) — MCP-сервер · ★ 6144
- [Dembrandt](https://affpapa.org/nevibecode/mcp/dembrandt.md) — MCP-сервер · ★ 3851

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md