
xcollantes/free-stock-images-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
無料のストック画像を取得するためのMCPサーバー.
概要
Unsplash、Pexels、Pixabay、Freepik、Burst、およびStockVaultを含む複数の無料のストック画像ソースへのアクセスを提供するモデルコンテキストプロトコル(MCP)サーバー。 - インポート : Access 6 人気の無料ストック画像プラットフォーム - 保存 : 単一のクエリですべてのソースを検索 - 参照 : 直接 URL を取得し、画像をダウンロード - 参照してください - ライセンス要件をチェックするガイダンス - AVE : 最小限の依存関係を持つ軽量サーバー - クエリ : より良い開発経験のための TypedDict 付きの包括的なタイプヒント - 🔌 : API キーが構成されるとき、実際の API 呼び出しのためのリクエストライブラリを使用して - ⚡ : API が利用できなくなったときにWeb検索リンクに戻って落ちる 1。 Claudeデスクトップコンフィグファイルに追加します。 : ~/Library/Application Support/Claude/claude desktop config.json : %APPDATA%\Claude\claude desktop config.json : %APPDATA%\Claude\claude desktop config.json : %APPDATA%\Claude\claude desktop config.json : %APPDATA%\Claude\claude desktop config.json : %APPDATA%\Claude\claude\claude desktop config.json : %APPDATA%\Claude\claude\claude\claude\claude\claude desktop desktop config.
概要(AI 翻訳)
複数の無料へのアクセスを提供するモデルコンテキストプロトコル(MCP)サーバー Unsplash、Pexels、Pixabay、Freepik、Burst、およびを含むストック画像ソース ストックボルト。
##特徴
- インポートマルチソース:アクセス6人気の無料ストックイメージプラットフォーム
- 匿名スマート検索: 単一のクエリですべてのソースを検索
- 直接リンク**: 画像を閲覧およびダウンロードするための直接URLを入手
- ライセンス情報**:ライセンス要件の確認に関するガイダンス
- OST ファスト&シンプル:最小限の依存関係を持つ軽量サーバー -Type Safe:TypedDictによる包括的なタイプのヒント
- 🔌APIインテグレーション:APIキーの設定時に、実際のAPIコール用の
requestsライブラリを使用する - ⚡スマートフォールバック: APIが利用できなくなったときにWeb検索リンクに戻ります
サポートされているストックイメージソース
| 出典 | 説明 | ライセンスの種類 | | ------------------------------------------------------------- |---------------- | |未だ | 美しい写真・画像 | 未だにライセンス | |Pexels | 無料ストック写真・ロイヤリティフリー画像 | 特典ライセンス | |Pixabay | 貴重品の無断転載を禁じます | Pixabay ライセンス |
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
Free Stock Images MCP Server
A Model Context Protocol (MCP) server that provides access to multiple free stock image sources including Unsplash, Pexels, Pixabay, Freepik, Burst, and StockVault.
Features
- 🎨 Multiple Sources: Access 6 popular free stock image platforms
- 🔍 Smart Search: Search across all sources with a single query
- 🔗 Direct Links: Get direct URLs to browse and download images
- 📋 License Info: Guidance on checking license requirements
- 🚀 Fast & Simple: Lightweight server with minimal dependencies
- 🔒 Type Safe: Comprehensive type hints with TypedDict for better development experience
- 🔌 API Integration: Uses
requestslibrary for real API calls when API keys are configured - ⚡ Smart Fallback: Falls back to web search links when APIs are unavailable
Supported Stock Image Sources
| Source | Description | License Type |
|---|---|---|
| Unsplash | Beautiful free photos & images | Unsplash License |
| Pexels | Free stock photos & royalty free images | Pexels License |
| Pixabay | Stunning royalty-free images & stock | Pixabay License |
| Freepik | Free vectors, stock photos, PSD and icons | Freepik License |
| Burst | Free stock photos for commercial use | CC0 |
| StockVault | Free graphics and photos | Various |
Quick Start
Installation
# Clone the repository
git clone https://github.com/your-username/free-stock-images-mcp.git
cd free-stock-images-mcp
# Create virtual environment
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
Usage with Claude Desktop
- Add to your Claude Desktop config file:
On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"free-stock-images": {
"command": "python",
"args": ["/path/to/free-stock-images-mcp/src/server.py"]
}
}
}
- Restart Claude Desktop
Usage with Other MCP Clients
Run the server directly:
python src/server.py
API Configuration (Optional)
For enhanced functionality with actual image data, configure API keys:
# Unsplash API (https://unsplash.com/developers)
export UNSPLASH_ACCESS_KEY=your_access_key_here
# Pexels API (https://www.pexels.com/api/)
export PEXELS_API_KEY=your_api_key_here
# Pixabay API (https://pixabay.com/api/docs/)
export PIXABAY_API_KEY=your_api_key_here
Benefits of API Configuration:
- Get actual image URLs and metadata
- Access image dimensions, author info, and download links
- Faster, more structured results
- Higher quality search results
インストール
npx @modelcontextprotocol/inspector python src/server.py設定
{
"mcpServers": {
"free-stock-images": {
"command": "python",
"args": ["/path/to/free-stock-images-mcp/src/server.py"]
}
}
}