leo-unsplash-mcp

Unsplash 배경화면을 Leo 프로바이더 패키지로 제공하며, MCP를 통해 동작합니다.

Leo의 배경화면 생성기는 이 작업을 직접 수행하지 않습니다. 프로바이더를 확인하고 그 프로바이더에게 요청합니다. 이 서버는 그중 하나로, 허브가 재빌드할 필요 없이 런타임에 설치하는 패키지로 제공됩니다.

응답 내용

leo_mcp::providers의 wallpaper 역할:

search_photos({ queries, orientation })
  -> { photos: [{ source_id, download_url, description, photographer }] }

결과는 텍스트 콘텐츠 블록의 JSON으로 반환되며, 이는 허브의 브리지가 읽는 규칙입니다.

Related MCP server: Unsplash Smart MCP Server

구성

이 프로세스에 Leo가 환경 변수로 전달합니다. 설정 키 그대로, 소문자로 전달되며, 설명자가 entitlements.settings_read에 선언하고 소유자가 동의한 키만 전달됩니다. 전체 설정 테이블은 절대 전달되지 않습니다.

키는 *_api_key가 아니라 unsplash_access_key입니다. 컴파일된 패키지의 설정 키와 일치합니다.

아무것도 구성되지 않으면 도구는 설정 이름을 명시한 isError를 반환합니다. 이는 의도적인 것입니다. 빈 응답은 실제 결과로 Leo에 도달하기 때문입니다.

실행

npm install
node index.js   # speaks MCP over stdio
npm test        # checks the response mapping, no network needed

순수 JavaScript를 사용하는 이유

이 패키지는 커밋 SHA에 고정된 git tarball로 배포되며, npm은 tarball URL에 대해 빌드 단계를 안정적으로 실행하지 않습니다. TypeScript 소스 트리는 설치된 후 다른 사람의 머신에서 시작에 실패할 수 있으며, 그런 경우 진단이 가장 어렵습니다.

레지스트리 항목은 전체 40자 커밋 SHA를 명시해야 합니다. 태그는 동일하게 구체적으로 보이지만 그렇지 않습니다. 항목이 검토된 후 이동될 수 있기 때문입니다.

라이선스

MIT