Suno MCP

Suno로 음악을 생성하기 위한 MCP(Model Context Protocol) 서버입니다.

기능

• 노래 생성: 맞춤형 가사와 스타일 태그 사용

• 설명으로 생성: Suno AI가 가사를 작성하도록 설정

• 완료 대기: 완료를 기다리고 마크다운 임베드가 포함된 오디오 URL 획득

• MP3 다운로드: 로컬 폴더로 MP3 다운로드

• 토큰 자동 갱신: 만료 시 자동 갱신

Related MCP server: Suno-MCP

요구 사항

• Node.js 18+

• BrowserOS(또는 --remote-debugging-port가 설정된 Chromium)가 http://localhost:9100에서 실행 중이며 Suno에 로그인된 상태여야 합니다. CDP_URL로 재정의 가능합니다.

• Suno 계정(무료 또는 유료)

설치

npm install

Claude Code와 함께 사용하기

.mcp.json에 추가하세요:

{
  "suno": {
    "command": "node",
    "args": ["/path/to/suno-mcp/src/index.js"]
  }
}

도구

작동 원리

인증

Suno는 단기 JWT 토큰을 사용하는 인증에 Clerk을 사용합니다. 클라이언트는 CDP를 통해 활성 Suno 탭에서 window.Clerk.session.getToken()을 호출합니다. Clerk이 내부적으로 갱신을 처리하므로 페이지를 새로 고칠 필요가 없습니다. 토큰은 exp 클레임 만료 5분 전까지 캐시됩니다.

노래 생성

직접적인 API 호출은 hCaptcha로 인해 실패합니다. 폼 선택자를 스크래핑하는 대신, 클라이언트는 Suno의 React 앱을 직접 제어합니다:

1. CDP를 통해 Suno 탭에 연결하고, 필요시 /create로 이동합니다.

2. 생성 버튼에서 React 파이버 트리를 탐색하여 onCreateClick / lyrics / styles / mode를 props로 노출하는 컴포넌트(의미론적 생성 핸들러)를 찾습니다.

3. React 호환 네이티브 setter를 사용하여 가사와 스타일 텍스트 영역을 채워 내부 상태를 업데이트합니다.

4. 파이버의 props에 새 값이 반영될 때까지(즉, React가 다시 렌더링될 때까지) 기다립니다.

5. CDP Input.dispatchMouseEvent를 통해 버튼 좌표에서 신뢰할 수 있는 마우스 클릭을 전달합니다. hCaptcha는 CDP로 합성된 이벤트를 실제 사용자 제스처로 인식합니다(JS에서 onCreateClick()을 호출하는 것은 거부됨).

6. CDP Network 이벤트를 통해 /api/generate/v2 응답을 캡처하여 새 클립 ID를 반환합니다. 네트워크 이벤트를 놓칠 경우 /api/project/default를 폴링하는 방식으로 대체합니다.

이 접근 방식은 UI 재설계에 강합니다. 클래스 이름, 텍스트 콘텐츠 일치 또는 DOM 레이아웃이 아닌, 의미론적 React props(onCreateClick, lyrics, styles)와 aria-label="Create song" 버튼(둘 다 핵심적인 요소로 변경 가능성이 낮음)에 의존하기 때문입니다.

예시

// Generate a song
const result = await suno_generate_song({
  lyrics: "[Verse]\nHello world\n\n[Chorus]\nThis is a test",
  style: "indie folk, acoustic, male vocals"
});

// Wait for it to complete
const songs = await suno_wait_for_songs({
  ids: result.songIds
});

// Download it
await suno_download_song({
  songId: songs[0].id,
  folder: "./downloads"
});

알려진 제한 사항

• 제목 필드가 안정적으로 작동하지 않습니다(Suno UI 제한 — 현재 새로운 생성 경로를 통해 연결되지 않음).

• generate_from_description(단순 모드)은 UI 모드 토글을 찾을 수 없는 경우 현재 사용자 지정 모드로 대체됩니다. 결정론적 동작을 위해서는 generate_song을 통해 가사와 스타일을 전달하세요.

• 활성화되고 표시되는 Suno 세션이 있는 BrowserOS가 필요합니다. 신뢰할 수 있는 클릭이 전달되려면 생성 버튼이 화면에서 0이 아닌 크기를 가져야 합니다.

• 토큰은 약 1시간마다 만료됩니다(Clerk을 통해 자동 갱신).

라이선스

MIT