핵심 기능
ListenHub MCP server로 할 수 있는 것 — 팟캐스트와 FlowSpeech 생성, 스피커 조회, 계정 확인.
ListenHub MCP server는 ListenHub의 오디오 생성 기능을 MCP 도구로 노출합니다. 각 도구는 공개된 OpenAPI 엔드포인트를 감싸고 있어, 여기서 할 수 있는 일은 OpenAPI를 직접 호출해서도 똑같이 할 수 있습니다. 정확한 도구 이름, 입력, 응답 구조는 사용 가능한 도구를 참고하세요.
팟캐스트 생성
주제나 원본 자료를 여러 스피커가 진행하는 팟캐스트(스크립트 + 오디오)로 바꿉니다.
- 한 번의 호출로 전체 생성(스크립트 + 오디오)을 마치거나, 스크립트를 먼저 검토하고 싶다면 텍스트만 생성할 수 있습니다.
- 스피커는 1~2명.
debate모드는 2인 호스트 형식이므로 speaker ID가 2개 필요합니다. - 세 가지 모드:
quick,deep,debate. - 스크립트 우선 워크플로: 스크립트를 먼저 생성해 편집한 다음, 편집한 스크립트로 오디오를 생성합니다.
- 콘텐츠 소스:
query프롬프트, 텍스트 단락, URL(query와sources를 함께 쓸 수 있습니다). - 상태 폴링은 제목, 개요, 커버, 오디오 URL, 자막, 스피커별 스크립트, 크레딧 사용량을 반환합니다.
언어는 zh 또는 en입니다.
FlowSpeech 생성
텍스트나 URL을 1인 내레이션으로 바꿉니다.
smart모드는 원본에 AI 보정을 적용하고,direct모드는 내용을 그대로 읽습니다.- 소스는
text(최소 10자) 또는url입니다. - 스피커는 정확히 한 명입니다.
- 상태 폴링은 제목, 개요, 커버, 오디오 URL, 자막, 내레이션 스크립트, 크레딧 사용량을 반환합니다.
스피커 조회
생성하기 전에 보이스 라이브러리를 둘러보세요.
- 사용 가능한 스피커 목록을 조회하며, 언어로 필터링할 수도 있습니다.
- 각 스피커는
speakerId, 이름, 언어, 성별, 데모 오디오 링크, 보이스 프로필(음높이, 말 속도, 특징, 스타일, 장면, 억양)을 가집니다. - 반환된
speakerId를 생성 도구의speakerIds/speakerId입력에 사용하세요.
계정과 크레딧
생성하기 전에 구독과 잔액을 확인하세요.
- 플랜 상세, 갱신 상태, 구독 시작 / 만료 날짜.
- 월간, 영구, 한정 기간 항목별로 나뉜 사용 가능 크레딧과 전체 크레딧, 그리고
totalAvailableCredits.
크레딧 비용은 도구마다 고정되어 있지 않습니다. 생성 전에 비용을 예상하려면 OpenAPI 레퍼런스의 해당 */estimate-credits 엔드포인트를 사용하고, 실시간 잔액은 get_user_subscription 도구로 확인하세요.
전송 방식
server는 기본적으로 stdio로 실행됩니다 — 모든 MCP 클라이언트(Claude Desktop, Cursor 등)가 별도 설정 없이 사용하는 모드입니다. 원격이나 공용 환경에서는 HTTP 모드로 실행할 수 있으며, 이 모드는 스트리머블(streamable) HTTP 엔드포인트(/mcp)와 Server-Sent Events 엔드포인트(/sse)를 함께 제공합니다. 자세한 내용은 전송 모드를 참고하세요.