Listenhub Mcp Server

ListenHub MCP 服务

ListenHub 官方 MCP 服务，支持 AI 播客生成（单人或双人对话）、FlowSpeech 创作等功能。ListenHub Pro 及更高版本套餐可用。

English | 简体中文

快速开始

环境配置

安装 Node.js

此服务要求 Node.js 版本为 18 或更高。如果尚未安装 Node.js，请按照以下说明操作：

• macOS 方法 1：使用官方安装程序
  1. 访问 Node.js 官方网站，下载 Node.js 长期支持版本，例如 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)"
  

  # After successful installation, use brew to download 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 包管理器） 如果使用的是 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 替换为你从 ListenHub 获取的实际 API 密钥。
• Cursor
  1. 打开 Cursor 设置
  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 替换为你从 ListenHub 获取的实际 API 密钥。 可选：HTTP 模式 若要使用 HTTP 传输，请手动启动服务：

  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 设置
  2. 前往 MCP Servers 部分
  3. 添加新的服务配置 配置文件位置：
  • 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 替换为你从 ListenHub 获取的实际 API 密钥。
• VS Code（通过 Cline 扩展）
  1. 从 VS Code Marketplace 安装 Cline 扩展
  2. 打开 VS Code 设置
  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 替换为你从 ListenHub 获取的实际 API 密钥。
• Zed Editor
  1. 打开 Zed 设置
  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 替换为你从 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 传输方式，便于灵活集成

传输模式

该服务支持多种传输模式，以适应不同的使用场景。

Stdio 模式（默认）

标准输入／输出通信。这是大多数 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：生成模式 - quick、deep 或 debate（字符串，可选，默认值：quick）
• get_podcast_status - 查询播客的详细信息。立即返回当前状态，不进行轮询。
  • episodeId：播客 ID（字符串，必需）
• create_podcast_text_only - 仅创建包含文本内容的播客（无音频）。这是两阶段生成的第一阶段。
  • query：内容或主题（字符串，可选）
  • sources：文本／URL 来源数组（数组，可选）
  • speakerIds：1-2 个说话人 ID 的数组（数组，必需）
  • language：语言代码 - zh 或 en（字符串，必需）
  • mode：生成模式 - quick、deep 或 debate（字符串，可选，默认值：quick）
  • 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：生成模式 - smart 或 direct（字符串，可选，默认值：smart）
• get_flowspeech_status - 查询 FlowSpeech 的详细信息。立即返回当前状态，无需轮询。
  • episodeId：FlowSpeech ID（字符串，必填）

用户账户查询

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

---

感谢使用 ListenHub MCP Server！

如有任何问题，请随时联系我们：[email protected]