Unsplash MCP 서버

영어 | 간체 중국어

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

📋 개요

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

Related MCP server: Smart Photo Journal MCP Server

✨ 특징

• 고급 이미지 검색 : Unsplash의 광범위한 사진 라이브러리에서 필터로 검색:

  • 키워드 관련성

  • 색상 구성표

  • 방향 옵션

  • 사용자 정의 정렬 및 페이지 매김

🔑 Unsplash 액세스 키 얻기

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

1. Unsplash 에서 개발자 계정을 만드세요

2. 새로운 애플리케이션을 등록하세요

3. 애플리케이션 세부 정보 페이지에서 액세스 키를 받으세요

4. 아래 구성 단계에서 이 키를 사용하세요.

자세한 내용은 공식 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 라이센스

📬 문의하기

• 트위터/X

• GitHub 문제