JS

joelio/stocky

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

28 stars 14 forks 品質 80 トレンド 31MIT

ストックフォトの検索とダウンロードのためのMCPサーバー.

概要

Stockyは、AIアシスタントの検索、検査、ロイヤリティフリーのストック写真をダウンロードできるMCPサーバーです。 stocky mcp.py でポイントすると、そのファイルがまだ存在してサーバーが起動します。 アップグレードには何も壊れません。 — ファイルがなくなったので、 setup.py です。 ソースチェックアウトから、または代わりにインストールします。 バージョン1.xから2分間のアップグレード、またはすべての変更のためのCHANGELOGを参照してください。 見出しの変更: pycurl がなくなった (C ビルドのエラーがなくなりました), 実際に並行して検索, 失敗したプロバイダは、何も返さないのではなく、なぜ報告, Python 3.10+ が必要です.

概要(AI 翻訳)

Stocky は、AI を可能にする MCP サーバーです。 アシスタント検索、検査、ロイヤリティフリーのストック写真をダウンロード Pexels と Unsplash.

###################?############################################################################################################################################################################################################################################ 詳しくはこちら ツイート

MCP クライアントのコンフィグが動作し続けます。 [stocky_mcp.py でポイントすると、 ファイルがまだ存在し、サーバーが起動します。 何も壊れない アップグレード。 ツイート [pip install -r requirements.txt]が失敗します — ファイルが消え、 [setup.pyです。 ソースチェックアウトから、**[uv syncでインストールするか pip install -e . ではなく。 1.xからアップグレードを見る 2分間のバージョン、またはすべての変更のためのCHANGELOG。 ツイート 見出しの変更: [pycurl] がなくなりました(C ビルドエラーがなくなりました)、 実際に並行して実行する検索, 失敗したプロバイダは、現在報告します why 何も返さない代わりに、Python 3.10+ が必要です。

✨ 機能

  • 複数のprovider search** — Pexels と Unsplash を同時にクエリ
  • 在留資格のメタデータ** - 寸法、写真、タグ、すべての画像サイズ
  • ライセンスアウェア** — プロバイダーが必要とするアトリビューションを生成し、 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" } } } }