joelio/stocky

joelio/stocky

от joelio
MCP сервер Stocky объединяет Pexels и Unsplash для поиска и скачивания стоковых изображений в один инструмент. Идеален для разработчиков и контент-мейкеров, которые хотят быстро получать визуалы че...

Stocky Logo
Stocky
Find beautiful royalty-free stock images 📸

CI Python 3.10+ MCP Compatible License: MIT

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

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить joelio/stocky:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "joelio-stocky-ys8jxhlc8h": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "stocky-mcp"
      ],
      "env": {
        "PEXELS_API_KEY": "your_pexels_key",
        "UNSPLASH_ACCESS_KEY": "your_unsplash_key"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"joelio-stocky-ys8jxhlc8h\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"stocky-mcp\"],\"env\":{\"PEXELS_API_KEY\":\"your_pexels_key\",\"UNSPLASH_ACCESS_KEY\":\"your_unsplash_key\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "joelio-stocky-ys8jxhlc8h": {
      "command": "uvx",
      "args": [
        "stocky-mcp"
      ],
      "env": {
        "PEXELS_API_KEY": "your_pexels_key",
        "UNSPLASH_ACCESS_KEY": "your_unsplash_key"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add joelio-stocky-ys8jxhlc8h --env PEXELS_API_KEY=your_pexels_key --env UNSPLASH_ACCESS_KEY=your_unsplash_key -- uvx stocky-mcp

Либо через JSON-конфиг:

claude mcp add-json joelio-stocky-ys8jxhlc8h "{\"command\":\"uvx\",\"args\":[\"stocky-mcp\"],\"env\":{\"PEXELS_API_KEY\":\"your_pexels_key\",\"UNSPLASH_ACCESS_KEY\":\"your_unsplash_key\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add joelio-stocky-ys8jxhlc8h --env PEXELS_API_KEY=your_pexels_key --env UNSPLASH_ACCESS_KEY=your_unsplash_key -- uvx stocky-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.joelio-stocky-ys8jxhlc8h]
command = "uvx"
args = ["stocky-mcp"]

[mcp_servers.joelio-stocky-ys8jxhlc8h.env]
PEXELS_API_KEY = "your_pexels_key"
UNSPLASH_ACCESS_KEY = "your_unsplash_key"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите joelio/stocky, а в поле команды запуска — строку ниже:
uvx stocky-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "joelio-stocky-ys8jxhlc8h": {
      "command": "uvx",
      "args": [
        "stocky-mcp"
      ],
      "env": {
        "PEXELS_API_KEY": "your_pexels_key",
        "UNSPLASH_ACCESS_KEY": "your_unsplash_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например joelio-stocky-ys8jxhlc8h.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: joelio-stocky-ys8jxhlc8h
    command: uvx
    args:
      - "stocky-mcp"
    env:
      PEXELS_API_KEY: your_pexels_key
      UNSPLASH_ACCESS_KEY: your_unsplash_key
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Похожие MCP-сервера

eyloni/pythia-oracle

eyloni/pythia-oracle

от eyloni

Сервер Pythia Oracle — творческий оракул для машин. Не даёт решений, а называет структуру ловушки, в которой вы застряли. Идеален для поиска неочевидных инсайтов и смены рамок мышления разработчикам и исследователям.

Python⭐ 1
Alisammour/storyflo-mcp

Alisammour/storyflo-mcp

от alisammour

MCP сервер Storyflo даёт LLM-агентам доступ к аудио-новостям: поиск статей по темам, получение текста и аудио, подписка на ленты. Полезен разработчикам для интеграции озвученного контента в ИИ-ассистенты.

JavaScript⭐ 2
CKBrennan/overtone-news-mcp

CKBrennan/overtone-news-mcp

от ckbrennan

Новостной MCP инструмент с анализом тональности и контекста. Отслеживает emerging stories, нарративные сдвиги и спайки эмоций. Идеален для ИИ-агентов, которым нужны смысл и тренды, а не просто заго...

Python⭐ 1
spokenmd/spoken

spokenmd/spoken

от spokenmd

Spoken - MCP сервер для поиска и получения расшифровок подкастов в Markdown с реальными именами спикеров. Идеален для LLM, RAG и AI-агентов. Автоматически разрешает имена, не требует загрузки аудио. Оплата за использование.

Python⭐ 5
cryptosquanch/legends-mcp

cryptosquanch/legends-mcp

от cryptosquanch

MCP сервер, который оживляет 36 легендарных фигур: от Маска до Баффетта. Задавай вопросы, получай советы и запускай Party Mode для дискуссии нескольких легенд. Идеально для стартап-идей, инвестицио...

TypeScript⭐ 9
gregario/lego-oracle

gregario/lego-oracle

от gregario

MCP сервер для поиска наборов, деталей и минифигурок LEGO. AI-ассистенты получают достоверные данные из каталога Rebrickable — 26 тысяч наборов, 62 тысячи деталей. Работает офлайн, без галлюцинаций. Полезен коллекционерам и разработчикам.

TypeScript⭐ 4
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин