
joelio/stocky
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Сервер MCP для поиска и загрузки стоковой фотографии.
Обзор
Stocky - это MCP-сервер, который позволяет помощнику ИИ искать, проверять и загружать безвозмездную стоковую фотографию из и. Если он указывает на stocky mcp.py, этот файл все еще там и все еще запускает сервер. Ничто не ломается при обновлении — этот файл исчез, как и setup.py. От источника проверки, установить с или вместо. Обновление с 1.x для двухминутной версии или изменение для всего. Заголовок изменился: pycurl исчез (так что больше не будет ошибок в сборке C), поиски фактически выполняются одновременно, неудачные провайдеры теперь сообщают, почему вместо того, чтобы ничего не возвращать, и Python 3.10 + требуется.
Обзор (машинный перевод)
Stocky - это MCP-сервер, который позволяет ИИ Помощник поиска, проверки и загрузки стоковой фотографии без роялти Pexels и Unsplash.
? Версия 2.0 — уже используется Stocky? Прочитайте это
Конфигурация клиента MCP продолжает работать. Если бы он был [0], Этот файл все еще там и все еще запускает сервер. Ничего не ломается
Модернизация.
** Но pip install -r requirements.txt потерпит неудачу ** — этот файл исчез.
Таково [2]. От источника проверки, установить с uv sync или
Вместо этого [4]. Обновление с 1.x
Для двухминутной версии или изменения для всего.
Изменения заголовка: pycurl исчезло (так что больше никаких ошибок в сборке C),
Поиски на самом деле выполняются одновременно, неудавшиеся поставщики теперь сообщают, почему
Вместо того, чтобы ничего не возвращать, требуется Python 3.10+.
Feature Особенности
- Многопоставочный поиск - запросы Pexels и Unsplash одновременно ** Богатые метаданные** — размеры, фотограф, теги и каждый размер изображения ** Лицензионное ** - генерирует атрибуцию, которую требует каждый поставщик, и Unsplash загрузок как их API руководящие принципы требуют
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
Stocky is an MCP server that lets an AI assistant search, inspect and download royalty-free stock photography from Pexels and Unsplash.
🆕 Version 2.0 — already using Stocky? Read this
Your MCP client config keeps working. If it points at
stocky_mcp.py, that file is still there and still starts the server. Nothing breaks on upgrade.But
pip install -r requirements.txtwill fail — that file is gone, and so issetup.py. From a source checkout, install withuv syncorpip install -e .instead. See Upgrading from 1.x for the two-minute version, or the CHANGELOG for everything.The headline changes:
pycurlis gone (so no more C build errors), searches actually run concurrently, failed providers now report why instead of returning nothing, and Python 3.10+ is required.
✨ Features
- 🔍 Multi-provider search — queries Pexels and Unsplash concurrently
- 📊 Rich metadata — dimensions, photographer, tags and every image size
- ⚖️ Licence-aware — generates the attribution each provider requires, and reports Unsplash downloads as their API guidelines demand
- ⏱️ Search caching — a short TTL cache keeps repeat queries off your quota
- 🛡️ Honest errors — a failing provider is reported, not silently returned as “no results”
- 🎯 Filters — orientation, colour and sort, validated per provider
Beautiful stock photography at your fingertips Example image used for demonstration purposes
Stunning landscapes available through multiple providers
Photo by Simon Berger on Unsplash
🚀 Quick start
1. Get API keys
Both are free:
| Provider | Where | Notes |
|---|---|---|
| Pexels 📷 | pexels.com/api | 200 requests/hour by default |
| Unsplash 🌅 | unsplash.com/developers | 50/hour in demo mode, 1000/hour once your app is approved |
You only need one — Stocky runs with whichever providers are configured.
2. Add it to your MCP client
The recommended configuration needs no installation at all:
{
"mcpServers": {
Установка
uvx stocky-mcpКонфигурация
{
"mcpServers": {
"stocky": {
"command": "uvx",
"args": ["stocky-mcp"],
"env": {
"PEXELS_API_KEY": "your_pexels_key",
"UNSPLASH_ACCESS_KEY": "your_unsplash_key"
}
}
}
}