ListenHub MCP

빠른 시작

Node.js를 설치하고 API 키를 발급받아 ListenHub MCP server를 클라이언트에 연결하세요.

ListenHub는 AI 팟캐스트 생성(1인 또는 2인 호스트), FlowSpeech 내레이션 및 관련 기능을 제공하는 공식 MCP server를 운영합니다.

MCP server는 API 키를 가진 모든 ListenHub 사용자가 이용할 수 있습니다. API 키는 모든 ListenHub 계정에서 자동으로 생성되므로, server를 연결하기 위한 플랜 조건은 없습니다. 팟캐스트, FlowSpeech, 오디오 생성은 플랜에 따라 크레딧을 소비합니다. 생성 전에 잔액을 확인하고 비용을 예상하려면 get_user_subscription 도구나 */estimate-credits 엔드포인트를 사용하세요.

빠른 시작

환경 설정

먼저 Node.js를 설치합니다.

MCP server는 Node.js 18 이상이 필요합니다. Node.js가 아직 설치되어 있지 않다면 아래 방법 중 하나를 따르세요.

  • macOS

    옵션 1: 공식 설치 프로그램

    1. Node.js 웹사이트에서 LTS 릴리스를 다운로드합니다. 예: v24.11.0 (LTS)
    2. 다운로드한 .pkg 파일을 열고 설치 프로그램의 안내를 따릅니다
    3. 터미널에서 설치를 확인합니다:
    node --version
npm --version

    옵션 2: Homebrew

    Homebrew가 설치되어 있지 않다면 다음 명령으로 설치합니다:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    이어서 Node.js를 설치합니다:

    brew install node

    설치를 확인합니다:

    node --version
npm --version

  • Windows

    옵션 1: 공식 설치 프로그램

    1. Node.js 웹사이트를 방문합니다
    2. Windows용 LTS 버전을 다운로드합니다
    3. 다운로드한 .msi 설치 프로그램을 실행합니다
    4. 설치 마법사의 안내를 따릅니다
    5. PowerShell에서 설치를 확인합니다:
    node --version
npm --version

    옵션 2: winget

    Windows 10 버전 1809 이상인 경우:

    winget install OpenJS.NodeJS.LTS

    설치를 확인합니다:

    node --version
npm --version

    옵션 3: Chocolatey

    Chocolatey를 사용할 수 있는 경우:

    choco install nodejs-lts

    설치를 확인합니다:

    node --version
npm --version

  • Linux

    Ubuntu/Debian

    # Install Node.js 20.x (LTS)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

    Fedora/RHEL/CentOS

    # Install Node.js 20.x (LTS)
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

    설치를 확인합니다:

    node --version
npm --version

ListenHub API 키를 발급받습니다.

ListenHub API 키 설정 페이지에서 API 키를 만들거나 확인한 다음, 환경 변수 LISTENHUB_API_KEY에 설정하세요. 키는 서버 사이드에 보관하세요 — 계정 크레딧에 대한 완전한 접근 권한을 갖습니다.

클라이언트별 설정 방법

  • Claude Desktop

    Claude Desktop 설정 파일을 편집합니다:

    macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    Windows: %APPDATA%\\Claude\\claude_desktop_config.json

    다음을 추가합니다:

    {
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

    your_api_key_here를 실제 API 키로 바꾸세요.

  • Cursor

    1. Cursor Settings를 엽니다
    2. Features -> Model Context Protocol로 이동합니다
    3. Add MCP Server를 클릭하거나 설정 파일을 직접 편집합니다

    설정 파일 위치:

    • macOS/Linux: ~/.cursor/mcp.json
    • Windows: %APPDATA%\\Cursor\\mcp.json

    다음을 추가합니다:

    {
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

    your_api_key_here를 실제 API 키로 바꾸세요.

    선택 사항: HTTP 전송 모드

    server를 직접 실행합니다:

    export LISTENHUB_API_KEY="your_api_key_here"
npx @marswave/listenhub-mcp-server --transport http --port 3000

    이어서 Cursor를 설정합니다:

    {
  "mcpServers": {
    "listenhub": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

  • Windsurf

    1. Windsurf Settings를 엽니다
    2. MCP Servers로 이동합니다
    3. 새 server 설정을 추가합니다

    설정 파일 위치:

    • macOS/Linux: ~/.windsurf/mcp_server_config.json
    • Windows: %APPDATA%\\Windsurf\\mcp_server_config.json

    다음을 추가합니다:

    {
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

    your_api_key_here를 실제 API 키로 바꾸세요.

  • VS Code (Cline 확장 사용)

    1. VS Code Marketplace에서 Cline 확장을 설치합니다
    2. VS Code Settings를 엽니다
    3. Cline: MCP Settings를 검색합니다
    4. Edit in settings.json을 클릭합니다

    다음을 추가합니다:

    {
  "cline.mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

    your_api_key_here를 실제 API 키로 바꾸세요.

  • Zed

    1. Zed Settings를 엽니다
    2. MCP 섹션으로 이동합니다
    3. 설정 파일을 편집합니다

    설정 파일 위치:

    • macOS/Linux: ~/.config/zed/mcp.json
    • Windows: %APPDATA%\\Zed\\mcp.json

    다음을 추가합니다:

    {
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

    your_api_key_here를 실제 API 키로 바꾸세요.

  • Claude CLI

    터미널에서 실행합니다:

    claude mcp add listenhub --env LISTENHUB_API_KEY=<insert-your-api-key-here> -- npx -y @marswave/listenhub-mcp-server

    <insert-your-api-key-here>를 실제 API 키로 바꾸세요.

  • Codex CLI

    터미널에서 실행합니다:

    codex mcp add listenhub --env LISTENHUB_API_KEY=<insert-your-api-key-here> -- npx -y @marswave/listenhub-mcp-server

    <insert-your-api-key-here>를 실제 API 키로 바꾸세요.

  • ChatWise

    1. ChatWise 설정을 열고 MCP를 선택한 다음 +를 클릭해 새 MCP 서비스를 추가합니다
    2. MCP 설정 항목을 입력합니다:

    ChatWise MCP 설정

    • Command: npx -y @marswave/listenhub-mcp-server@latest
    • Run tools automatically 활성화
    • 환경 변수 LISTENHUB_API_KEY를 추가하고 값에 자신의 키를 입력
    1. 채팅 입력 영역에서 도구를 활성화하고 사용을 시작합니다

  • 그 밖의 MCP 클라이언트

    다른 MCP 호환 클라이언트에서는 표준 MCP 형식을 사용합니다:

    {
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

    your_api_key_here를 실제 API 키로 바꾸세요.

다음 단계

사용 예시

자주 쓰는 흐름을 프롬프트부터 도구 호출까지 따라가며 설명.

사용 가능한 도구

8개 MCP 도구의 입력, 제약, 응답 구조.

MCP Server

ListenHub의 오디오 생성 기능을 Claude Desktop, Cursor 등 MCP 클라이언트 안에서 MCP 도구로 사용하세요.

사용 예시

팟캐스트, FlowSpeech, 스크립트 우선 흐름, 스피커 조회, 계정 확인을 프롬프트부터 도구 호출까지 따라가며 설명합니다.

이 페이지의 내용

빠른 시작환경 설정클라이언트별 설정 방법다음 단계