# listenhub-mcp-server
## 基本信息
- Slug: `marswaveai-listenhub-mcp-server`
- Source: modelscope
- Publisher: @marswaveai/listenhub-mcp-server
- Categories: audio-processing / multimedia-processing / entertainment-and-media
- Hosted: No
- License: Apache License 2.0
- Source URL: https://www.modelscope.cn/mcp/servers/@marswaveai/listenhub-mcp-server
## 简介
暂无描述。
## 安装提示

```bash
node --version npm --version
```

## MCP Server 详情

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

Official MCP Server for [ListenHub](https://listenhub.ai/), 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](https://nodejs.org/) and download the Node.js Long Term Support version, such as [v24.11.0(LTS)](https://nodejs.org/dist/v24.11.0/node-v24.11.0.pkg)
  2. Open the downloaded `.pkg` file and follow the installation wizard
  3. Open Terminal and run the following commands to verify installation:
  ```bash
  node --version
  npm --version
  ```
  **Method 2: Using Homebrew**
  If you don't have [Homebrew](https://brew.sh/) installed, use the following script to install it:
  ```bash
  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  ```
  ```bash
  # After successful installation, use brew to download Node.js
  brew install node
  ```
  Then verify the installation:
  ```bash
  node --version
  npm --version
  ```
- Windows
  **Method 1: Using Official Installer**
  1. Visit the [Node.js official website](https://nodejs.org/)
  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:
  ```bash
  node --version
  npm --version
  ```
  **Method 2: Using winget (Windows Package Manager)**
  If you're using Windows 10 version 1809 or higher:
  ```bash
  winget install OpenJS.NodeJS.LTS
  ```
  Then verify the installation:
  ```bash
  node --version
  npm --version
  ```
  **Method 3: Using Chocolatey**
  If you have Chocolatey installed:
  ```bash
  choco install nodejs-lts
  ```
  Then verify the installation:
  ```bash
  node --version
  npm --version
  ```
- Linux
  **Ubuntu/Debian**
  ```bash
  # 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**
  ```bash
  # 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:
  ```bash
  node --version
  npm --version
  ```

Get ListenHub API Key

Get your API key from the [ListenHub API Keys Settings](https://listenhub.ai/en/settings/api-keys) 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:
  ```json
  {
    "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:
  ```json
  {
    "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:
  ```bash
  export LISTENHUB_API_KEY="your_api_key_here"
  npx @marswave/listenhub-mcp-server --transport http --port 3000
  ```
  Then configure Cursor:
  ```json
  {
    "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:
  ```json
  {
    "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 …

