AI导哈

播客生成服务器

ListenHub MCP Server是一个支持AI播客生成（单人或双人）、FlowSpeech创建等功能的服务器，适用于ListenHub Pro及以上计划用户。

  • by marswaveai
  • TypeScript
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 marswaveai/listenhub-mcp-server

使用说明

ListenHub MCP Server

官方MCP服务器 ListenHub，支持AI播客生成（单扬声器或双扬声器）、FlowSpeech创建等。适用于ListenHub Pro计划及以上。



English | 简体中文

快速开始

环境配置

安装Node.js

此服务器需要Node.js版本18或更高版本。如果你还没有安装Node.js，请按照以下说明操作：

  • macOS 方法1：使用官方安装程序
    1. 访问 Node.js官方网站 并下载Node.js长期支持版本，例如 v24.11.0（长期支持版本）
    2. 打开下载的 .pkg 文件并按照安装向导进行操作
    3. 打开终端并运行以下命令以验证安装：
    node --version
npm --version
    方法2：使用自制咖啡 如果你没有 家酿 已安装，请使用以下脚本进行安装：
    /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
    然后验证安装：
    node --version
npm --version
  • 视窗 方法1：使用官方安装程序
    1. 访问 Node.js官方网站
    2. 下载适用于Windows的LTS（长期支持）版本
    3. 运行下载的 .msi 安装程序
    4. 按照安装向导进行操作
    5. 打开PowerShell并运行以下命令以验证安装：
    node --version
npm --version
    方法2：使用winget（Windows软件包管理器） 如果您使用的是Windows 10 1809或更高版本：
    winget install OpenJS.NodeJS.LTS
    然后验证安装：
    node --version
npm --version
    方法3：使用巧克力 如果您安装了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密钥

从获取API密钥 ListenHub API密钥设置 页面并将其用作 LISTENHUB_API_KEY 环境变量。

每个客户端的配置方法

  • 克劳德桌面版 编辑您的Claude Desktop配置文件： macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %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 使用从ListenHub获得的实际API密钥。
  • 光标
    1. 打开光标设置
    2. 导航至 特性 → 模型上下文协议
    3. 点击 添加MCP服务器 或直接编辑配置文件 配置文件位置:
    • macOS/Linux: ~/.cursor/mcp.json
    • 视窗: %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 使用从ListenHub获得的实际API密钥。 可选：HTTP模式 要使用HTTP传输，请手动启动服务器：
    export LISTENHUB_API_KEY="your_api_key_here"
npx @marswave/listenhub-mcp-server --transport http --port 3000
    然后配置游标：
    {
  "mcpServers": {
    "listenhub": {
      "url": "http://localhost:3000/mcp"
    }
  }
}
  • 帆板运动
    1. 打开风帆设置
    2. 导航到 MCP服务器 部分
    3. 添加新的服务器配置 配置文件位置:
    • macOS/Linux: ~/.windsurf/mcp_server_config.json
    • 视窗: %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 使用从ListenHub获得的实际API密钥。
  • VS代码（通过Cline扩展）
    1. 安装 临床扩展 来自VS代码市场
    2. 打开VS代码设置
    3. 搜索“临床：MCP设置”
    4. 点击“在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 使用从ListenHub获得的实际API密钥。
  • Zed编辑
    1. 打开Zed设置
    2. 导航到MCP部分
    3. 编辑配置文件 配置文件位置:
    • macOS/Linux: ~/.config/zed/mcp.json
    • 视窗: %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 使用从ListenHub获得的实际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> 使用从ListenHub获得的实际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> 使用从ListenHub获得的实际API密钥。
  • ChatWise
    1. 打开ChatWise设置，选择MCP，单击“+”添加新的MCP服务
    2. 在MCP配置模块中填写以下信息：
      • 命令： npx -y @marswave/listenhub-mcp-server@latest
      • 环境变量：添加 LISTENHUB_API_KEY 使用API密钥作为值
    3. 启用聊天输入框下方的工具以开始使用它
  • 其他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 使用从ListenHub获得的实际API密钥。

用法示例

生成英语播客

核心功能

  • 播客生成:
    • 支持全代（文本+音频）或纯文本生成
    • 支持1-2个扬声器，可定制声音
    • 多代模式：快速聆听、深度探索、辩论
    • 支持两级发电
    • 支持文本和URL内容源
    • 查询播客生成状态
    • 访问音频文件、标题、脚本和大纲
    • 跟踪信贷消费
  • FlowSpeech语音生成:
    • 将文本或URL中的书面内容转换为单扬声器对话音频
    • 支持智能模式（AI增强阅读）或直接模式（逐字阅读）
    • 查询FlowSpeech生成状态
    • 访问音频文件、标题、脚本和大纲
    • 跟踪信贷消费
  • 演讲者管理:
    • 浏览可用的扬声器/语音库
    • 按语言和说话者属性筛选
    • 获取演讲者ID、姓名、语言、性别和演示音频
  • 用户帐户管理:
    • 查询订阅状态和计划信息
    • 查看学分使用情况：每月学分、永久学分和限时学分
    • 监控总可用学分和续订状态
    • 查看订阅开始/到期日期
  • 多种运输方式：支持Stdio、HTTP SSE和HTTP Streamable传输方法，实现灵活集成

运输方式

服务器支持多种传输模式，以适应不同的用例。

标准模式（默认）

标准输入/输出通信。这是大多数MCP客户端（如Claude Desktop、Cursor等）使用的默认模式。

上述所有配置示例默认使用stdio模式，无需额外设置。

HTTP/SSE模式

对于高级用例，您可以在HTTP模式下运行服务器，提供HTTP流和服务器发送事件（SSE）端点。

以HTTP模式启动服务器：

# macOS/Linux
export LISTENHUB_API_KEY="your_api_key_here"
npx @marswave/listenhub-mcp-server --transport http --port 3000
# Windows
set LISTENHUB_API_KEY=your_api_key_here

npx @marswave/listenhub-mcp-server --transport http --port 3000

可用端点：

  • HTTP流媒体： http://localhost:3000/mcp
  • 服务器发送的事件： http://localhost:3000/sse

配置您的MCP客户端以使用HTTP端点：

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

可用工具

演讲者查询

  • get_speakers -获取可用于播客生成的扬声器列表。返回说话者ID、姓名、语言、性别和演示音频链接。
    • language：按语言代码筛选（zh/en）（字符串，可选）

播客生成

  • create_podcast -创建一个全代播客（文本+音频）。支持1-2个扬声器。自动轮询直到完成（可能需要几分钟）。
    • query：内容或主题（字符串，可选）
    • sources：文本/URL源数组（数组，可选）
    • speakerIds：1-2个扬声器ID的数组（数组，必填）
    • language：语言代码-zh或en（字符串，可选，默认值：en）
    • mode：生成模式-快速、深入或辩论（字符串，可选，默认：快速）
  • get_podcast_status -查询播客的详细信息。立即返回当前状态，无需轮询。
    • episodeId：播客ID（字符串，必填）
  • create_podcast_text_only -创建仅包含文本内容（无音频）的播客。两阶段发电的第一阶段。
    • query：内容或主题（字符串，可选）
    • sources：文本/URL源数组（数组，可选）
    • speakerIds：1-2个扬声器ID的数组（数组，必填）
    • language：语言代码-zh或en（字符串，必填）
    • mode：生成模式-快速、深入或辩论（字符串，可选，默认：快速）
    • waitForCompletion：等待生成完成（布尔值，可选，默认值：true）
  • generate_podcast_audio -使用现有文本内容为播客生成音频。第二阶段为两阶段发电。
    • episodeId：播客ID（字符串，必填）
    • customScripts：自定义脚本数组（数组，可选）
    • waitForCompletion：等待生成完成（布尔值，可选，默认值：true）

FlowSpeech生成

  • create_flowspeech -将文本或URL内容转换为语音，创建FlowSpeech。支持智能模式（AI增强）和直接模式（无需修改）。
    • sourceType：源类型-文本或url（字符串，必填）
    • sourceContent：源内容（文本或URL）（字符串，必填）
    • speakerId：旁白的演讲者ID（字符串，必填）
    • language：语言代码-zh或en（字符串，可选）
    • mode：生成模式-智能或直接（字符串，可选，默认：智能）
  • get_flowspeech_status -查询FlowSpeech的详细信息。立即返回当前状态，无需轮询。
    • episodeId：FlowSpeech ID（字符串，必填）

用户帐户查询

  • get_user_订阅 -获取当前用户的订阅信息，包括订阅状态、信用额度使用情况、计划详细信息和续订状态。

感谢您使用ListenHub MCP服务器！

如果您有任何疑问，请随时与我们联系：support@marswave.ai

相关 MCP