영어 | 简体中文

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

📋 개요

Unsplash MCP 서버는 풍부하고 고품질의 이미지를 검색하는 데 사용됩니다. Unsplash 기능을 자신의 애플리케이션에 통합하고자 하는 개발자에게 이상적입니다.

✨ 특징

• 고급 이미지 검색: 다음 필터가 포함된 Unsplash의 방대한 사진 라이브러리 검색
• 키워드 관련성
• 색상 구성
• 방향 옵션
• 맞춤 정렬 및 페이지네이션

🔑 언스플래시 접근 키 획득 중

이 서버를 설치하기 전에 언스플래시 API 접근 키를 받아야 합니다:

1. Unsplash에서 개발자 계정 생성
2. 신규 신청서 등록
3. 지원 정보 페이지에서 접근 키를 받으세요
4. 아래 설정 단계에서 이 키를 사용하세요

자세한 내용은 공식 Unsplash API 문서를 참고하세요.

🚀 설치

Smithery를 통해 Claude Desktop용 Unsplash 이미지 통합 서버를 자동으로 설치하려면:

IDE 설정

커서 IDE

윈드서핑

클라인

수동 설치

커서 에디터 통합

커서 편집기의 settings.json에 다음 구성을 추가하세요:

Unsplash MCP Server

English | 简体中文

A simple MCP server for seamless Unsplash image integration and search capabilities.

📋 Overview

Unsplash MCP Server is used for searching rich, high-quality images. It’s ideal for developers who want to integrate Unsplash functionality into their own applications.

✨ Features

• Advanced Image Search: Search Unsplash’s extensive photo library with filters for:
  • Keyword relevance
  • Color schemes
  • Orientation options
  • Custom sorting and pagination

🔑 Obtaining Unsplash Access Key

Before installing this server, you’ll need to obtain an Unsplash API Access Key:

1. Create a developer account at Unsplash
2. Register a new application
3. Get your Access Key from the application details page
4. Use this key in the configuration steps below

For more details, refer to the official Unsplash API documentation.

🚀 Installation

To install Unsplash Image Integration Server for Claude Desktop automatically via Smithery:

IDE Setup

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-****-****

Manual 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

Add the following configuration to your Cursor editor’s settings.json:

⚠️ Note: Please adjust the following configuration according to your actual installation:

• If uv is not in your system PATH, use an absolute path (e.g., /path/to/uv)
• ./server.py should be modified to the actual location of your server script (can use absolute path or path relative to workspace)