Stock Images MCP — MCP-сервер для Claude Code: как установить
Ищет и сохраняет бесплатные стоковые фотографии с Pexels, Unsplash и Pixabay прямо через чат с ассистентом. Пригодится при сборке макетов, статей и интерфейсов.
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Что делает Stock Images MCP
Сервер даёт агенту два инструмента: search_images для поиска по базам стоков и download_image для сохранения файлов на диск. Поиск можно ограничить конкретным сервисом или запустить сразу по всем настроенным источникам. Доступна фильтрация по альбомной или портретной ориентации. В ответе приходят размеры, ссылка на превью, адрес скачивания и данные фотографа для указания авторства.
Загрузка защищена от типовых проблем с файловой системой. Скрипт принимает только ответы с типом image/*, ограничивает размер файла лимитом 50 МиБ и отсекает запросы дольше 30 секунд. Все файлы отправляются в папку ./downloads или каталог из переменной STOCK_IMAGES_DOWNLOAD_DIR. Попытки выйти за пределы разрешённого каталога через симлинки сервер блокирует, а существующие файлы никогда не перезаписывает.
Для запуска нужен Node.js 22 или новее. Также потребуется ключ хотя бы для одного сервиса: Pexels, Unsplash или Pixabay. Без ключа соответствующий сервис работать не будет.
Какие задачи решает
- найти стоковые фотографии под интерфейс или статью через диалог с агентом
- скачать изображения в папку проекта без ручного перехода в браузер
- сохранить имя автора и ссылку на профиль для выполнения условий лицензии
- отфильтровать снимки по вертикальной или горизонтальной ориентации
Примеры запросов агенту
- Найди пять фотографий современного офиса в альбомной ориентации на Unsplash и покажи авторов.
- Поищи на Pexels портретные снимки разработчиков и скачай лучший вариант в папку downloads.
- Скачай изображение по ссылке из Pixabay и сохрани его под именем banner.jpg.
Как установить Stock Images MCP
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Stock Images MCP
Как установить Stock Images MCP в Claude Code?
Выполните команду `claude mcp add stock-images-mcp -e PEXELS_API_KEY=<PEXELS_API_KEY> -e UNSPLASH_API_KEY=<UNSPLASH_API_KEY> -e PIXABAY_API_KEY=<PIXABAY_API_KEY> -- npx -y stock-images-mcp`. Вместо плейсхолдеров укажите свои ключи API.
Что делает Stock Images MCP?
Он предоставляет инструменты search_images и download_image. С их помощью агент ищет фото на Pexels, Unsplash и Pixabay, после чего сохраняет выбранные кадры в локальную папку проекта.
Нужно ли регистрировать ключи сразу во всех трёх сервисах?
Нет, сервер запустится даже с одним настроенным сервисом. Запросы будут отправляться только в те базы, для которых заданы переменные окружения.
