Unsplash MCP Server
Unsplash MCP-Server
Englisch | 简体中文
Ein einfacher MCP-Server für die nahtlose Unsplash-Bildintegration und Suchfunktionen.
📋 Übersicht
Der Unsplash MCP-Server wird verwendet, um nach umfangreichen, hochwertigen Bildern zu suchen. Er ist ideal für Entwickler, die Unsplash-Funktionen in ihre eigenen Anwendungen integrieren möchten.
Related MCP server: Unsplash MCP Server
✨ Funktionen
Erweiterte Bildsuche: Durchsuchen Sie die umfangreiche Fotobibliothek von Unsplash mit Filtern für:
Schlüsselwortrelevanz
Farbschemata
Ausrichtungsoptionen
Benutzerdefinierte Sortierung und Paginierung
🔑 Erhalt des Unsplash-Zugriffsschlüssels
Bevor Sie diesen Server installieren, müssen Sie einen Unsplash API-Zugriffsschlüssel (Access Key) erhalten:
Erstellen Sie ein Entwicklerkonto bei Unsplash
Registrieren Sie eine neue Anwendung
Holen Sie sich Ihren Zugriffsschlüssel von der Seite mit den Anwendungsdetails
Verwenden Sie diesen Schlüssel in den Konfigurationsschritten unten
Weitere Details finden Sie in der offiziellen Unsplash API-Dokumentation.
🚀 Installation
So installieren Sie den Unsplash Image Integration Server für Claude Desktop automatisch über Smithery:
IDE-Einrichtung
Cursor IDE
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --key 7558c683-****-****Windsurf
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-****Cline
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --key 7558c683-****-****Manuelle Installation
# Clone the repository
git clone https://github.com/hellokaton/unsplash-mcp-server.git
# Navigate to project directory
cd unsplash-mcp-server
# Create virtual environment
uv venv
# Install dependencies
uv pip install .Cursor-Editor-Integration
Fügen Sie die folgende Konfiguration zur settings.json Ihres Cursor-Editors hinzu:
⚠️ Hinweis: Bitte passen Sie die folgende Konfiguration an Ihre tatsächliche Installation an:
Wenn
uvnicht in Ihrem System-PATH enthalten ist, verwenden Sie einen absoluten Pfad (z. B./path/to/uv)./server.pysollte auf den tatsächlichen Speicherort Ihres Serverskripts angepasst werden (kann ein absoluter Pfad oder ein Pfad relativ zum Arbeitsbereich sein)
{
"mcpServers": {
"unsplash": {
"command": "uv",
"args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
"env": {
"UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
}
}
}
}Verwendung in Cursor
🛠️ Verfügbare Tools
Fotos suchen
{
"tool": "search_photos",
"query": "mountain",
"per_page": 5,
"orientation": "landscape"
}🔄 Andere Implementierungen
Golang: unsplash-mcp-server
Java: unsplash-mcp-server
📄 Lizenz
📬 Kontakt
Available Tools
1 toolsearch_photosA
Search for Unsplash photos
Args:
query: Search keyword
page: Page number (1-based)
per_page: Results per page (1-30)
order_by: Sort method (relevant or latest)
color: Color filter (black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, blue)
orientation: Orientation filter (landscape, portrait, squarish)
Returns:
List[UnsplashPhoto]: List of search results containing photo objects with the following properties:
- id: Unique identifier for the photo
- description: Optional text description of the photo
- urls: Dictionary of available image URLs in different sizes
- width: Original image width in pixels
- height: Original image height in pixels
Inputs: query (required), page, per_page, order_by, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'search_photos' has a clearly defined and distinct purpose.
The single tool follows a clear verb_noun pattern ('search_photos'), and with only one tool, there is perfect consistency by definition.
A single tool for an Unsplash server feels thin and incomplete for the domain. While search is a core function, typical photo services would include additional operations like getting photo details, downloading, or user-related actions.
The tool surface is severely incomplete for an Unsplash server. There are significant gaps: no ability to get photo details by ID, download photos, access user profiles, collections, or statistics. The server only supports search, which limits agent workflows.
Maintenance
Related MCP Connectors
An MCP server for search and retrieval over a local LanceDB database
The OpenRouter MCP server plugs OpenRouter into the AI tools you already use. Once connected, your assistant can pull live OpenRouter data (models, prices, your credits, rankings, and docs) and send quick test messages, all without leaving your editor.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Unofficial Serper MCP — wraps the Serper Google Search API (serper.dev)
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables users to search for high-quality photos on Unsplash with support for advanced filtering by orientation and content safety. It provides formatted photo metadata and images in either base64-encoded format or as JSON with URLs via stdio transport.144 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and downloading photos from Unsplash via the Unsplash API, with support for pagination, orientation filtering, and multiple resolutions.46 npm1MIT
- AlicenseAqualityDmaintenanceAn MCP server for searching and retrieving photos from Unsplash with proper attribution, designed for LLMs building content pages.338MIT
- AlicenseAqualityDmaintenanceMCP server that enables searching and downloading Unsplash photos and collections.4MIT