MCP Spotify Server

아티스트렌즈

Spotify 웹 API에 대한 액세스를 제공하는 강력한 모델 컨텍스트 프로토콜(MCP) 서버입니다. ArtistLens는 Spotify 음악 카탈로그와의 원활한 상호 작용을 지원하여 트랙, 앨범, 아티스트 검색은 물론, 인기 트랙 및 관련 아티스트와 같은 아티스트별 정보에 대한 접근을 제공합니다.

현재 버전: 0.4.12

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 ArtistLens를 자동으로 설치하려면:

지엑스피1

수동 설치

패키지를 글로벌하게 설치할 수 있습니다:

또는 npx로 직접 실행하세요.

구성

MCP 설정 파일에 다음을 추가합니다(예: claude_desktop_config.json 또는 cline_mcp_settings.json ):

Spotify API 자격 증명을 제공해야 합니다.

1. Spotify 개발자 대시보드 로 이동
2. 새로운 애플리케이션을 만듭니다
3. 클라이언트 ID와 클라이언트 비밀번호를 받으세요
4. 위에 표시된 대로 구성에 추가하세요.

특징

• 트랙, 앨범, 아티스트 및 재생 목록을 검색하세요
• 인기 트랙과 관련 아티스트를 포함한 아티스트 정보를 얻으세요
• 앨범 정보 및 트랙 가져오기
• 새로운 릴리스 및 권장 사항에 액세스하세요
• 시장별 콘텐츠와 챕터가 담긴 오디오북 정보를 받아보세요
• 참고: 오디오북 엔드포인트에는 추가 인증이나 시장별 액세스가 필요할 수 있습니다.
• 재생 목록 정보(이름, 설명, 공개/비공개 상태)를 가져오고 수정합니다.
• 페이지 매김 지원으로 재생 목록 트랙 및 항목에 액세스
• Spotify ID와 URI 모두 지원
• 클라이언트 자격 증명 흐름을 통한 자동 토큰 관리
• 모든 기능에 대한 포괄적인 테스트 모음
• 관심사 분리를 통한 잘 정리된 코드

사용 가능한 도구

• get_access_token : 유효한 Spotify 액세스 토큰을 가져옵니다.
• search : 트랙, 앨범, 아티스트 또는 재생 목록을 검색합니다.
• get_artist : 아티스트 정보 가져오기
• get_artist_top_tracks : 아티스트의 최고 트랙을 가져옵니다.
• get_artist_related_artists : 주어진 아티스트와 유사한 아티스트를 가져옵니다.
• get_artist_albums : 아티스트의 앨범을 가져옵니다
• get_album : 앨범 정보 가져오기
• get_album_tracks : 앨범의 트랙을 가져옵니다
• get_track : 트랙 정보 가져오기
• get_available_genres : 추천 가능한 장르 목록을 가져옵니다.
• get_new_releases : 새 앨범 발매 소식을 받아보세요
• get_recommendations : 시드 트랙, 아티스트 또는 장르를 기반으로 트랙 추천을 받습니다.
• get_audiobook : 선택적 시장 매개변수를 사용하여 오디오북 정보를 가져옵니다.
• get_multiple_audiobooks : 여러 오디오북에 대한 정보를 가져옵니다(최대 50개)
• get_audiobook_chapters : 페이지 번호 지정 기능을 통해 오디오북의 챕터를 가져옵니다(요청당 1~50개 챕터)
• get_playlist : Spotify 사용자가 소유한 재생 목록을 가져옵니다.
• get_playlist_tracks : 재생 목록의 트랙에 대한 전체 세부 정보를 가져옵니다(요청당 1~100개 트랙)
• get_playlist_items : 재생 목록 항목의 전체 세부 정보를 가져옵니다(요청당 1~100개 항목)
• modify_playlist : 재생 목록 세부 정보(이름, 설명, 공개/비공개 상태, 협업 상태)를 변경합니다.
• add_tracks_to_playlist : 선택적인 위치를 사용하여 하나 이상의 트랙을 재생 목록에 추가합니다.
• remove_tracks_from_playlist : 선택적 위치 및 스냅샷 ID를 사용하여 재생 목록에서 하나 이상의 트랙을 제거합니다.
• get_current_user_playlists : 현재 Spotify 사용자가 소유하거나 팔로우하는 재생 목록 목록을 가져옵니다(요청당 1~50개 재생 목록)
• get_featured_playlists : 선택적 로케일 및 페이지 매김 지원이 포함된 Spotify 추천 재생 목록 목록을 가져옵니다.
• get_category_playlists : 특정 카테고리로 태그된 Spotify 재생 목록 목록을 가져옵니다.

업데이트 중

최신 버전으로 업데이트하려면:

개발

이 프로젝트는 오픈 소스이며 GitHub의 https://github.com/superseoworld/artistlens 에서 사용할 수 있습니다.

프로젝트 구조

코드베이스는 다음 디렉토리로 구성됩니다.

• src/handlers/ : 다양한 Spotify API 엔드포인트에 대한 핸들러 클래스가 포함되어 있습니다.
• src/types/ : 요청 및 응답 객체에 대한 TypeScript 인터페이스
• src/utils/ : API 통신을 위한 유틸리티 함수 및 클래스
• src/__tests__/ : 모든 기능에 대한 Jest 테스트 파일

테스트

이 프로젝트는 테스트에 Jest를 사용합니다. 테스트를 실행하려면 다음을 수행하세요.

개발 중에 감시 모드에서 테스트를 실행하려면:

기여하다

기여하려면:

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항에 대한 테스트를 추가합니다.
4. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
5. 브랜치에 푸시( git push origin feature/amazing-feature )
6. 풀 리퀘스트 열기

특허

MIT 라이센스