Unsplash MCP 서버

Name: Unsplash MCP Server
Author: hellokaton

영어 | 간체 중국어

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

파이썬 3.9 이상 라이센스: MIT 대장간 배지

📋 개요

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

Related MCP server: Smart Photo Journal MCP Server

✨ 특징

고급 이미지 검색 : Unsplash의 광범위한 사진 라이브러리에서 필터로 검색:
- 키워드 관련성
- 색상 구성표
- 방향 옵션
- 사용자 정의 정렬 및 페이지 매김

🔑 Unsplash 액세스 키 얻기

이 서버를 설치하기 전에 Unsplash API 액세스 키를 얻어야 합니다.

Unsplash 에서 개발자 계정을 만드세요
새로운 애플리케이션을 등록하세요
애플리케이션 세부 정보 페이지에서 액세스 키를 받으세요
아래 구성 단계에서 이 키를 사용하세요.

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

🚀 설치

Smithery를 통해 Claude Desktop용 Unsplash Image Integration Server를 자동으로 설치하려면:

IDE 설정

커서 IDE

지엑스피1

윈드서핑

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-****

클라인

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 .

커서 편집기 통합

커서 편집기의 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}" } } } }