joelio/stocky

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

28 stars 14 forks 품질 80 트렌드 31MIT

Repository Install

MCP 서버 검색 및 다운로드 재고 사진.

개요

Stocky는 AI 조수 검색, 검사 및 다운로드 로열티 무료 재고 사진 및 . Stocky mcp.py에서 점이면 파일이 여전히 존재하고 여전히 서버를 시작합니다. 아무것도 업그레이드에 휴식. — 그 파일은 사라지고, 그래서 setup.py입니다. 소스 체크 아웃에서, 설치 또는 대신. 두 분 버전의 1.x에서 업그레이드하거나 모든 것을 위해 CHANGELOG를 참조하십시오. 헤드 라인 변경 사항 : pycurl은 사라집니다 (그래서 더 많은 C 빌드 오류가 없습니다), 실제로 concurrently를 실행, 실패 공급자는 이제 아무것도 반환하는 이유를보고, Python 3.10 +가 필요합니다.

개요(AI 번역)

Stocky는 AI를 할 수있는 MCP 서버입니다. 조수 검색, 검사 및 다운로드 royalty-free 재고 사진에서 Pexels 및 Unsplash.

☸ 버전 2.0 - 이미 Stocky를 사용? 자세히보기

** 당신의 MCP 클라이언트 구성은 작동을 지킵니다. ** stocky_mcp.py에서 점이 있는 경우, 그 파일이 여전히 있고 여전히 서버를 시작합니다. 아무것도에 휴식 업그레이드. · **하지만 pip install -r requirements.txt가 실패 ** — 그 파일이 사라지고, setup.py입니다. 소스 체크 아웃에서 uv sync 또는 pip install -e . 대신. 1.x에서 업그레이드 2 분 버전 또는 모든 것을 위한 CHANGELOG. · 헤드라인 변경: pycurl가 사라집니다 (그래서 더 많은 C 빌드 오류), 검색은 실제로 concurrently, 실패한 공급자는 지금 보고합니다 why 아무것도 반환하지 않고 Python 3.10+가 필요합니다.

✨ 특징

PhysicsMulti-provider search — queries Pexels 과 Unsplash concurrently
R **Rich metadata ** - 치수, 사진 작가, 태그 및 모든 이미지 크기
ܧ️Licence-aware - 각 공급자의 기여를 생성하고, Unsplash는 API 가이드라인 수요로 다운로드합니다

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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": {

GitHub에서 전체 README 보기

설치

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"
      }
    }
  }
}