Unsplash MCP Server

이 프로젝트는 Model Context Protocol (MCP)을 지원하는 어플리케이션(Claude Desktop, Cursor 등)에서 Unsplash의 사진 검색 및 데이터 기능을 연동하여 사용할 수 있도록 해주는 MCP 서버입니다.

기능 (Features)

이 서버는 다음과 같은 툴(Tools)을 제공합니다:

• search_photos: 키워드, 색상, 방향 등의 필터를 기반으로 사진 검색
• get_random_photo: 랜덤 사진 가져오기 (키워드, 컬렉션 제한 가능)
• list_topics: Unsplash에서 관리하는 토픽(카테고리) 목록 조회
• get_topic_photos: 특정 토픽의 사진 조회
• get_collection_photos: 특정 컬렉션의 사진 조회
• get_photo: 단일 사진의 상세 정보 조회
• get_photo_statistics: 특정 사진의 조회수 및 다운로드 통계 확인

사전 준비 (Prerequisites)

이 서버를 사용하려면 Unsplash Developer 계정과 API Access Key가 필요합니다.

1. Unsplash Developers에 접속하여 회원가입/로그인합니다.
2. 새 애플리케이션을 생성합니다.
3. 발급된 Access Key를 복사합니다.

설치 및 사용 (Installation & Usage)

Claude Desktop에서 사용하기

Claude Desktop의 환경설정 파일(mcp_config.json)을 열고 아래와 같이 등록합니다.

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unsplash-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@aitutorlab/unsplash-mcp"
      ],
      "env": {
        "UNSPLASH_ACCESS_KEY": "여기에_발급받으신_언스플래시_키_입력"
      }
    }
  }
}

설정 후 Claude Desktop을 재시작하면 Claude가 필요에 따라 자동으로 이 서버의 툴을 호출하여 이미지를 검색합니다.

라이선스

ISC License