Skip to main content
Glama

Unsplash MCPサーバー

English | 简体中文

Unsplashの画像統合と検索機能をシームレスに実現するシンプルなMCPサーバーです。

Python 3.9+ License: MIT

Trust Score

📋 概要

Unsplash MCPサーバーは、豊富で高品質な画像を検索するために使用されます。Unsplashの機能を自身のアプリケーションに統合したい開発者に最適です。

Related MCP server: Unsplash MCP Server

✨ 機能

  • 高度な画像検索: Unsplashの広大な写真ライブラリを、以下のフィルターを使用して検索できます:

    • キーワードの関連性

    • 配色

    • 向きのオプション

    • カスタムソートとページネーション

🔑 Unsplashアクセスキーの取得

このサーバーをインストールする前に、Unsplash APIアクセスキーを取得する必要があります:

  1. Unsplashで開発者アカウントを作成します

  2. 新しいアプリケーションを登録します

  3. アプリケーション詳細ページからアクセスキーを取得します

  4. 以下の設定手順でこのキーを使用します

詳細については、公式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"
}

🔄 その他の実装

📄 ライセンス

MIT License

📬 お問い合わせ

Available Tools

1 tool
search_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

    A3.5/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    The single tool follows a clear verb_noun pattern ('search_photos'), and with only one tool, there is perfect consistency by definition.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      1
      44 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and downloading photos from Unsplash via the Unsplash API, with support for pagination, orientation filtering, and multiple resolutions.
      46 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for searching and retrieving photos from Unsplash with proper attribution, designed for LLMs building content pages.
      3
      38
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that enables searching and downloading Unsplash photos and collections.
      4
      MIT