XF

xcollantes/free-stock-images-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

17 stars 10 forks 质量 62 趋势 21MIT

MCP服务器用于获取免费库存图像.

概览

一个模式上下文协议(MCP)服务器,提供访问多个免费股票图像源,包括Unsplash,Pexels,Pixabay,Freepik,Burst,和StockVault. - QQ: 存取 6 受欢迎的自由股票图像平台 - QQ: 以单一查询搜索所有来源 - QQ: 获取直接URL来浏览并下载图像 - QQ: 关于检查许可证要求的指导意见 - QQ: 依赖性最小的轻量级服务器 - QQ: 带有TypedDict的综合类型提示,以获得更好的开发经验 - QQ: 配置API密钥时使用真实 API 调用库 - : API不可用时掉回网络搜索链接 1. 在您的 Claude 桌面配置文件中添加: :~/图书馆/应用程序支持/Claude/claude desktop config.json :%APDATA+Claude desktop config.

概述(AI 翻译)

一个提供多个免费访问的模型上下文协议服务器 库存图像来源,包括Unsplash、Pexels、Pixabay、Freepik、Burst和 斯托克韦尔.

□ 特性

  • 多来源:访问6个大众免费股票图像平台
  • ####Smart搜索**: 用单一查询搜索所有来源
  • 直接链接**: 获取直接 URL 浏览并下载图像
  • License Info:关于检查许可证要求的指导
  • 快活 & 简单:依赖性最小的轻量级服务器
  • ** Type Safety**:综合类型提示,包含TypedDict,以获得更好的发展经验
  • ** API 集成**: 配置 API 密钥时用于真实 API 调用库
  • ? ? ? ? ? ? ? ? ? 无法使用 API 时返回网页搜索链接

□ 支持的库存图像源

来源 描述 许可证类型 |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ################美丽自由相片和图像########################################################################################################################################################################################################################################## 免费股票照片和特许使用费 ################################################################################################################################################################################################################################################################

本页由 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 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
在 GitHub 查看完整 README

安装

npx @modelcontextprotocol/inspector python src/server.py
新手?先看 mcpskill.org 教程 →

配置

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