XF

xcollantes/free-stock-images-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

17 stars 10 forks Качество 62 Тренд 21MIT

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 requests library 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

  1. 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"]
    }
  }
}
  1. 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
Открыть полный README на GitHub

Установка

npx @modelcontextprotocol/inspector python src/server.py
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "free-stock-images": { "command": "python", "args": ["/path/to/free-stock-images-mcp/src/server.py"] } } }