Unsplash MCP Server
Unsplash MCPサーバー
English | 简体中文
Unsplashの画像統合と検索機能をシームレスに実現するシンプルなMCPサーバーです。
📋 概要
Unsplash MCPサーバーは、豊富で高品質な画像を検索するために使用されます。Unsplashの機能を自身のアプリケーションに統合したい開発者に最適です。
Related MCP server: Unsplash MCP Server
✨ 機能
高度な画像検索: Unsplashの広大な写真ライブラリを、以下のフィルターを使用して検索できます:
キーワードの関連性
配色
向きのオプション
カスタムソートとページネーション
🔑 Unsplashアクセスキーの取得
このサーバーをインストールする前に、Unsplash APIアクセスキーを取得する必要があります:
Unsplashで開発者アカウントを作成します
新しいアプリケーションを登録します
アプリケーション詳細ページからアクセスキーを取得します
以下の設定手順でこのキーを使用します
詳細については、公式Unsplash APIドキュメントを参照してください。
🚀 インストール
Smithery経由でClaude Desktop用のUnsplash画像統合サーバーを自動的にインストールするには:
IDE設定
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-****-****手動インストール
# 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エディタへの統合
Cursorエディタのsettings.jsonに以下の設定を追加します:
⚠️ 注意: 実際のインストール環境に合わせて以下の設定を調整してください:
uvがシステムPATHにない場合は、絶対パス(例:/path/to/uv)を使用してください./server.pyは、サーバーのスクリプトの実際の場所(絶対パス、またはワークスペースからの相対パス)に変更してください
{
"mcpServers": {
"unsplash": {
"command": "uv",
"args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
"env": {
"UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
}
}
}
}Cursorでの使用
🛠️ 利用可能なツール
写真の検索
{
"tool": "search_photos",
"query": "mountain",
"per_page": 5,
"orientation": "landscape"
}🔄 その他の実装
Golang: unsplash-mcp-server
Java: unsplash-mcp-server
📄 ライセンス
📬 お問い合わせ
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