Unsplash MCP Server

@cevatkerim

リポジトリ

基本情報

カテゴリ

その他

ライセンス

MIT

トランスポート

stdio

作者

cevatkerim

投稿者

Kerim Incedayi

Unsplash MCP Server について

An MCP server for Unsplash photo search with proper attribution built-in. Key differentiator: Returns ready-to-use attribution_text and attribution_html for each photo, making it trivial for LLMs to build content pages with properly credited images (as required by Unsplash API g

#unsplash #images #photos #stock-photos #attribution #mcp #fastmcp #python #llm #content #search

Unsplash MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "unsplash": {
      "type": "stdio",
      "command": "/path/to/unsplash-mcp/.venv/bin/fastmcp",
      "args": [
        "run",
        "/path/to/unsplash-mcp/server.py"
      ],
      "env": {
        "UNSPLASH_ACCESS_KEY": "your_access_key_here"
      }
    }
  }
}

Unsplash MCP Server のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Unsplash Mcp?

An MCP (Model Context Protocol) server for fetching photos from Unsplash with proper attribution. It is designed for LLMs building content pages that need properly credited images.

How to use Unsplash Mcp?

Install Python 3.11+, obtain an Unsplash API access key, clone the repository, create a virtual environment, install dependencies (fastmcp, httpx, python-dotenv), set the key in a .env file, then run the server with fastmcp run server.py. Configure the server in your MCP client (e.g., Claude Code, Cursor, Windsurf/Cline) by providing the command path, arguments, and the UNSPLASH_ACCESS_KEY environment variable.

Key features of Unsplash Mcp

Search photos by keyword with filters (color, orientation)
Get random photos for variety in content
Download tracking compliant with Unsplash API guidelines
Full attribution including ready-to-use text and HTML
Pre-formatted attribution strings optimized for LLM embedding

Use cases of Unsplash Mcp

An LLM building a blog post includes credited landscape photos
A content-generation app selects a random nature image for a hero section
A website generator searches for coffee shop images and embeds attribution HTML
An AI assistant tracks downloads when a user saves an image

よくある質問

What do I need to run Unsplash Mcp?

Python 3.11+ and an Unsplash API access key (available from unsplash.com/developers). Dependencies include fastmcp, httpx, and python-dotenv.

What are the rate limits?

Demo mode: 50 requests per hour. Production mode: 5,000 requests per hour (after approval).

Does the server handle Unsplash attribution requirements?

Yes. Every photo response includes `attribution_text` and `attribution_html` strings. You must use these when displaying images.

Can I hotlink images from Unsplash using this server?

Yes. The returned URLs are meant to be used directly, which enables view tracking in compliance with Unsplash API guidelines.

Do I need to track downloads?

Yes, if you offer a download link. Use the `track_download` tool with the photo ID to comply with Unsplash API guidelines.

「その他」の他のコンテンツ

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one