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长期支持版本，例如 v24.11.0（长期支持版本） 1. 打开下载的 .pkg 文件并按照安装向导进行操作 1. 打开终端并运行以下命令以验证安装：

  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. 访问 1. 下载适用于Windows的LTS（长期支持）版本 1. 运行下载的 .msi 安装程序 1. 按照安装向导进行操作 1. 打开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. 打开光标设置 1. 导航至 特性 → 模型上下文协议 1. 点击 添加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. 打开风帆设置 1. 导航到 MCP服务器 部分 1. 添加新的服务器配置 配置文件位置: - 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代码市场 1. 打开VS代码设置 1. 搜索“临床：MCP设置” 1. 点击“在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设置 1. 导航到MCP部分 1. 编辑配置文件 配置文件位置: - 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= -- npx -y @marswave/listenhub-mcp-server

替换 `` 使用从ListenHub获得的实际API密钥。

• Codex CLI

在终端中运行以下命令：

  codex mcp add listenhub --env LISTENHUB_API_KEY= -- npx -y @marswave/listenhub-mcp-server

替换 `` 使用从ListenHub获得的实际API密钥。

• ChatWise

1. 打开ChatWise设置，选择MCP，单击“+”添加新的MCP服务 1. 在MCP配置模块中填写以下信息： - 命令： npx -y @marswave/listenhub-mcp-server@latest - 环境变量：添加 LISTENHUB_API_KEY 使用API密钥作为值 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 使用从ListenHub获得的实际API密钥。

用法示例

生成英语播客

image.png

核心功能

• 播客生成:

- 支持全代（文本+音频）或纯文本生成 - 支持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