kanana_mcp_03_implement_01

claude code 프롬프트

프로젝트 개요(claude.md)

## mcp 구현 설계

- 가수와 곡을 input으로 받아 api 검색 후 추천곡 리스트를 만드는 일종의 도메인 특화 딥서치 mcp 서버
- 동작 예시
input :
"화사의 good goodbye를 타이틀 곡으로 한 앨범 만들어 줘" 
output : 
Album: Good Goodbye
Artist: 화사, 헤이즈 ... 프롬
Genre: R&B / Soul / Alternative Pop
Mood:  이별 → 미련과 자책 → 감정 바닥 → 자존 회복 → 이별 직후의 감정 정리
playlist: https://youtube.com/playlist?list=예시

## tool 구성
3가지 요청을 대응할 수 있는 3가지 툴을 구성할 것이다.
첫번째로 검색 요청에 대한 서치 툴이다. meta 검색과 웹검색 api를 하나로 묶어 곡 정보에 대한 검색을 대응할 것이다.
두번째로 추천 요청에 대한 딥서치 툴이다. 메타 검색과 웹검색된 내용을 기반으로 주제를 추출하고 서사를 생성하여 관련 주제와 서사에 맞는 노래, 음악을 추천해준다.
세번째로 생성 요청에 대한 유튜브 api 툴이다. 플레이리스트를 만들고 곡을 추가해준다.

referece 폴더 구성

• MCP docs : mcp 서버 공식 문서
• aimusic-mcp-tool : 오픈소스 mcp 서버
• audio-player-mcp : 오픈소스 mcp 서버
• llm-jukebok : 오픈소스 mcp 서버

프롬프트

이슈

• plan 모드를 사용해서인지 클로드 코드가 자꾸 자세하고 범위를 넓게 구조를 만들려고 해서, playmcp 와 데코레이트를 사용해서 검색만 되는 간단한 코드를 작성해달라고 재요청함.
•  
• soptiyfy api 이슈,(https://community.spotify.com/t5/Spotify-for-Developers/Unable-to-create-app/td-p/7283365/page/7)

추천을 어떻게 할 것인가?

• 곡의 메타데이터 검색과 서사 작성 초안은 완성되었다.
  
  
• 서사 기반으로 스토리와 키워드를 만들고 키워드에 알맞는 곡들을 추천 하게 만들고 싶은데, 추천을 어떻게 할 것인가에 대한 고민이 생겼다.
• 단순하게 "이별 노래" 추천 받았을 때 수많은 곡 중 어떤 노래를 추천해줘야하지...?
  
  
• 검색 쿼리를 좀 더 디테일하게 짜야 하나?, 벡터 검색이 가능하다면 좋을 것 같은데, 자체 db 를 만드는 것은 더 말이 안되는 것 같고, 지식도 부족하지만, 방법에 대한 고민이 더 필요하다.

차주 계획

• 추천 로직 개선
• stdio 로 구현된 코드 http 서버로 구현
• 홈 서버 활용 mcp서버 오픈
• OAuth 보안 설정