Tunetank MCP

Tunetank MCP 서버

Tunetank 음악 및 사운드 이펙트 카탈로그를 MCP 서버로 — 모든 AI 어시스턴트(Claude, ChatGPT, Cursor 등)가 비디오, 광고, 팟캐스트 또는 스트림에 적합한 로열티 프리 트랙이나 SFX를 찾을 수 있습니다.

"YouTube 인트로용으로 약 60초 길이의 활기찬 록 트랙 찾아줘" 또는 "2초 미만의 휙 SFX" 와 같이 요청하면 어시스턴트가 Tunetank의 실제 카탈로그를 검색하여 미리보기 링크와 tunetank.com의 트랙 페이지를 제공합니다.

• 🎵 분위기, 장르, 테마, 아티스트, 이름 및 목표 길이(± 허용 오차) 로 음악 검색
• 🔊 카테고리 및 길이로 사운드 이펙트(SFX) 검색
• 📚 장르, 분위기, 테마 및 큐레이션된 플레이리스트 탐색
• ▶️ 모든 결과에는 오디오 미리보기 URL 및 공식 트랙 페이지(https://tunetank.com/track/<id>-<slug>/) 포함
• 🆓 완전 무료 — API 키, 인증, 사용량 제한 가입 불필요. 읽기 전용.

---

서버

엔드포인트	https://mcp.tunetank.com
전송	스트리밍 가능 HTTP (JSON‑RPC 2.0)
인증	없음 (공개, 읽기 전용)
비용	무료

---

설정

MCP 지원 클라이언트를 위의 엔드포인트로 지정하세요. 일반적인 클라이언트에 대한 예시:

Claude Desktop / Claude.ai (커넥터)

다음 URL로 사용자 정의 커넥터 추가:

https://mcp.tunetank.com

또는 mcp-remote 브릿지를 사용하여 설정 파일(claude_desktop_config.json)을 통해:

{
  "mcpServers": {
    "tunetank": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tunetank.com"]
    }
  }
}

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "tunetank": {
      "url": "https://mcp.tunetank.com"
    }
  }
}

VS Code / 기타 클라이언트

원격 (HTTP) MCP 서버를 지원하는 모든 클라이언트 — URL https://mcp.tunetank.com을 사용하세요. 표준 입출력만 지원하는 클라이언트의 경우 npx -y mcp-remote https://mcp.tunetank.com으로 브릿지하세요.

---

도구

도구	인수	반환값
search_music	query, name, artist, genre, mood, theme, duration, tolerance, limit	트랙: 이름, 아티스트, 길이, bpm, 미리보기 URL, 트랙 페이지 URL, 장르/분위기/테마
search_sfx	query, category, duration, tolerance, limit	사운드 이펙트: 이름, 길이, 미리보기 URL, 파형
list_genres	—	모든 음악 장르 (id, name, alias)
list_moods	—	모든 음악 분위기 (id, name, alias)
list_themes	—	모든 음악 테마 (id, name, alias)
list_playlists	limit	큐레이션된 플레이리스트 (이름, 설명, 트랙 수)

인수 참고 사항

• query (search_music) — 자유 텍스트; 트랙 이름 또는 아티스트 이름과 일치합니다.
• genre / mood / theme — 이름/별칭(예: "rock", "happy") 또는 숫자 id(list_* 도구에서 가져옴)를 허용합니다.
• duration — 목표 길이(초).
• tolerance — duration 주변의 허용 ± 초 (기본값 5). 예: duration: 60, tolerance: 10 → 50초에서 70초 사이의 트랙.
• category (search_sfx) — SFX 카테고리 이름 또는 id.
• limit — 최대 결과 수 (기본값 20, 최대 50; 플레이리스트 기본값 50, 최대 200).

모든 문자열 필터는 부분 일치, 대소문자 구분 없음입니다. 게시된 트랙/SFX만 반환됩니다.

---

예시

"활기찬 록, 약 60초, 인트로용"

{
  "name": "search_music",
  "arguments": { "genre": "rock", "mood": "energetic", "duration": 60, "tolerance": 10, "limit": 5 }
}

"2초 미만의 짧은 휙 사운드 이펙트"

{
  "name": "search_sfx",
  "arguments": { "query": "whoosh", "duration": 1.5, "tolerance": 1.5 }
}

샘플 트랙 결과

{
  "id": 2270,
  "name": "Adventures",
  "artist": "A Himitsu",
  "duration": 138,
  "bpm": 120,
  "url": "https://tunetank.com/track/2270-adventures/",
  "preview": "https://…/preview.mp3",
  "genres": ["Pop"],
  "moods": ["Happy", "Inspiring"],
  "themes": ["Vlog"]
}

---

사용해 보기 (원시 JSON‑RPC)

전송은 사양을 엄격히 따르므로 Content-Type 및 Accept 헤더를 모두 포함하세요:

# List available tools
curl -s https://mcp.tunetank.com \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Search music
curl -s https://mcp.tunetank.com \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_music","arguments":{"mood":"happy","duration":60,"tolerance":10,"limit":3}}}'

---

라이선스

모든 음악은 개인 및 비상업적 목적으로 무료 사용 가능합니다.

그 외의 경우(상업 프로젝트, 광고, 수익 창출 콘텐츠, 클라이언트 작업 등)에는 tunetank.com을 방문하여 해당 라이선스 조건을 확인하세요.

---

정보

음악 및 사운드 이펙트는 Tunetank에서 제공합니다 — 크리에이터를 위한 로열티 프리 오디오. 이 MCP 서버는 발견 채널입니다: 미리보기와 트랙 페이지를 반환하여 tunetank.com에서 듣고 트랙을 가져올 수 있도록 합니다. 다운로드 및 라이선스는 사이트에서 이루어집니다.

질문이나 문제가 있으신가요? support@tunetank.com으로 문의하세요.