remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides advanced image search capabilities for Unsplash's photo library, allowing filtering by keyword relevance, color schemes, orientation options, with custom sorting and pagination.

Unsplash MCP 서버

영어 | 간체 중국어

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

📋 개요

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

✨ 특징

고급 이미지 검색 : 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}"
      }
    }
  }
}

커서에서 사용

🛠️ 사용 가능한 도구

사진 검색

{
  "tool": "search_photos",
  "query": "mountain",
  "per_page": 5,
  "orientation": "landscape"
}

🔄 기타 구현

Golang: unsplash-mcp-server
자바: unsplash-mcp-server

📄 라이센스

MIT 라이센스

📬 문의하기

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

search_photos

Unsplash의 이미지 라이브러리와 원활하게 통합되는 가벼운 서버로, 개발자는 커서 편집기에서 다양한 필터를 적용하여 고품질 사진을 직접 검색할 수 있습니다.

Related Resources

Reddit Discussion about this server

Unsplash MCP Server