JS

joelio/stocky

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

28 stars 14 forks Качество 80 Тренд 31MIT

Сервер 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.txt will fail — that file is gone, and so is setup.py. From a source checkout, install with uv sync or pip install -e . instead. See Upgrading from 1.x for the two-minute version, or the CHANGELOG for everything.

The headline changes: pycurl is 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": {
Открыть полный README на GitHub

Установка

uvx stocky-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "stocky": { "command": "uvx", "args": ["stocky-mcp"], "env": { "PEXELS_API_KEY": "your_pexels_key", "UNSPLASH_ACCESS_KEY": "your_unsplash_key" } } } }