listenhub-mcp-server

<h1 align="center">ListenHub MCP Server</h1>

Official MCP Server for ListenHub, supporting AI podcast generation (single or dual-speaker), FlowSpeech creation, and more. Available for ListenHub Pro plan and above.

<p align="center"> <a href="https://listenhub.ai"><img alt="ListenHub website" src="https://img.shields.io/badge/Made%20by%20ListenHub-000?logo=listenhub&logoColor=fff&logoSize=auto" /></a> <a href="https://discord.gg/ZbwA7g2guU"><img alt="Discord" src="https://img.shields.io/discord/1365293903405645886?label=Discord&logo=discord&color=eee&labelColor=5865f2&logoColor=fff" /></a> <a href="https://x.com/ListenHub"><img alt="ListenHub X/Twitter" src="https://img.shields.io/twitter/follow/ListenHub?logo=x" /></a> <br /> <a href="https://www.npmjs.com/package/%40marswave%2Flistenhub-mcp-server"><img alt="npm version" src="https://img.shields.io/npm/v/%40marswave%2Flistenhub-mcp-server?logo=npm" /></a> <a href="https://github.com/marswaveai/listenhub-mcp-server/blob/main/LICENSE"><img alt="license" src="https://img.shields.io/npm/l/%40marswave%2Flistenhub-mcp-server?color=blue" /></a> <br /> English | <a href="https://github.com/marswaveai/listenhub-mcp-server/blob/main/README_zh.md">简体中文</a> </p>

Quick Start

Environment Configuration

Installing Node.js

This server requires Node.js version 18 or higher. If you haven't installed Node.js yet, please follow the instructions below:

• macOS Method 1: Using Official Installer
  1. Visit the Node.js official website and download the Node.js Long Term Support version, such as v24.11.0(LTS)
  2. Open the downloaded .pkg file and follow the installation wizard
  3. Open Terminal and run the following commands to verify installation:

  node --version
  npm --version
  

  Method 2: Using Homebrew If you don't have Homebrew installed, use the following script to install it:

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

  # After successful installation, use brew to download Node.js
  brew install node
  

  Then verify the installation:

  node --version
  npm --version
  

• Windows Method 1: Using Official Installer
  1. Visit the Node.js official website
  2. Download the LTS (Long Term Support) version for Windows
  3. Run the downloaded .msi installer
  4. Follow the installation wizard
  5. Open PowerShell and run the following commands to verify installation:

  node --version
  npm --version
  

  Method 2: Using winget (Windows Package Manager) If you're using Windows 10 version 1809 or higher:

  winget install OpenJS.NodeJS.LTS
  

  Then verify the installation:

  node --version
  npm --version
  

  Method 3: Using Chocolatey If you have Chocolatey installed:

  choco install nodejs-lts
  

  Then verify the installation:

  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
  

  Verify the installation:

  node --version
  npm --version
  

Get ListenHub API Key

Get your API key from the ListenHub API Keys Settings page and use it as the value for the LISTENHUB_API_KEY environment variable.

Configuration Methods for Each Client

• Claude Desktop Edit your Claude Desktop configuration file: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Add the following configuration:

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

  Replace your_api_key_here with your actual API key obtained from ListenHub.
• Cursor
  1. Open Cursor Settings
  2. Navigate to Features Model Context Protocol
  3. Click Add MCP Server or directly edit the configuration file Configuration file location:
  • macOS/Linux: ~/.cursor/mcp.json
  • Windows: %APPDATA%\Cursor\mcp.json Add the following configuration:

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

  Replace your_api_key_here with your actual API key obtained from ListenHub. Optional: HTTP Mode To use HTTP transport, manually start the server:

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

  Then configure Cursor:

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

• Windsurf
  1. Open Windsurf Settings
  2. Navigate to the MCP Servers section
  3. Add new server configuration Configuration file location:
  • macOS/Linux: ~/.windsurf/mcp_server_config.json
  • Windows: %APPDATA%\Windsurf\mcp_server_config.json Add the following configuration:

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

  Replace your_api_key_here with your actual API key obtained from ListenHub.
• VS …