
joelio/stocky
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
ストックフォトの検索とダウンロードのための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.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"
}
}
}
}