Skip to main content
Glama

Unsplash MCP 서버

영어 | 简体中文

원활한 Unsplash 이미지 통합 및 검색 기능을 위한 간단한 MCP 서버입니다.

Python 3.9+ License: MIT

신뢰 점수

📋 개요

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 라이선스

📬 연락처

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