
xcollantes/free-stock-images-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
MCP сервер для получения бесплатных стоковых изображений.
Обзор
Сервер Model Context Protocol (MCP), который предоставляет доступ к нескольким бесплатным источникам изображений акций, включая Unsplash, Pexels, Pixabay, Freepik, Burst и StockVault. - a : Доступ к 6 популярным бесплатным платформам изображений акций - a : Поиск по всем источникам с одним запросом - a : Получение прямых URL-адресов для просмотра и загрузки изображений - a : Руководство по проверке требований лицензии - a : Легкий сервер с минимальными зависимостями - a : Всесторонние подсказки типа с TypedDict для лучшего опыта разработки - a : Использует библиотеку запросов для реальных вызовов API, когда настроены ключи API - a : Возвращается к ссылкам веб-поиска, когда API недоступны 1. Добавьте файл конфигурации Claude Desktop: : ~/Library/Application Support/Claude/claude desktop config.json : %APPDATA%\Claude\claude desktop config.
Обзор (машинный перевод)
Сервер Model Context Protocol (MCP), обеспечивающий доступ к нескольким бесплатным серверам Источники изображений акций, включая Unsplash, Pexels, Pixabay, Freepik, Burst и СтокВоло.
Особенности
Множественные источники: Доступ к 6 популярным бесплатным платформам стоковых изображений
Умный поиск : Поиск по всем источникам с одним запросом
Прямые ссылки: Получите прямые URL-адреса для просмотра и загрузки изображений
** Лицензионная информация: Руководство по проверке лицензионных требований
Быстрый и простой: легкий сервер с минимальными зависимостями
peType Safe: Всесторонние подсказки типа с TypedDict для лучшего опыта разработки
**API Интеграция : использует библиотеку requests для реальных вызовов API при настройке ключей API
Умный Fallback: Возврат к ссылкам веб-поиска, когда API недоступны
Поддерживаемые источники изображений
| Источник | Описание | Тип лицензии
** Unsplash** | Красивые бесплатные фотографии и изображения | Unsplash License | | Pexels | Бесплатные стоковые фотографии и бесплатные изображения | Лицензия Pexels | Pixabay | Потрясающие изображения без роялти и акции | Лицензия Pixabay
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
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"]
}
}
}