核心功能
ListenHub MCP server 能做什么——播客与 FlowSpeech 生成、音色查询、账户查询。
ListenHub MCP server 把 ListenHub 的音频生成能力封装为 MCP 工具。每个工具都对应一个公开的 OpenAPI 端点,因此这里能做的事,你同样可以直接调用 OpenAPI 完成。工具的具体名称、入参和返回结构见可用工具。
播客生成
把一个主题或素材转换为多人播客(脚本 + 音频)。
- 一次调用完成完整生成(脚本 + 音频),或先只生成文本以便先审脚本。
- 1 到 2 位说话人。
debate模式为双主持人格式,需要 2 个 speaker ID。 - 三种模式:
quick、deep、debate。 - 先审后录流程:先生成脚本,编辑后再用你改好的脚本生成音频。
- 内容来源:
query提示词、文本段落、URL(query与sources可组合使用)。 - 状态轮询返回标题、大纲、封面、音频 URL、字幕、分说话人脚本以及积分消耗。
语言为 zh 或 en。
FlowSpeech 生成
把文本或 URL 转换为单人朗读。
smart模式对原文做 AI 润色;direct模式逐字朗读原文。- 来源为
text(至少 10 个字符)或url。 - 恰好一位说话人。
- 状态轮询返回标题、大纲、封面、音频 URL、字幕、朗读脚本以及积分消耗。
音色查询
生成前先浏览音色库。
- 列出可用说话人,可按语言筛选。
- 每位说话人都带有
speakerId、名称、语言、性别、试听音频链接,以及音色画像(音高、语速、特征、风格、场景、口音)。 - 把返回的
speakerId用于生成工具的speakerIds/speakerId入参。
账户与积分
生成前先查询订阅与余额。
- 套餐信息、续订状态、订阅开始 / 到期日期。
- 按月度、永久、限时三类拆分的可用与总积分,以及
totalAvailableCredits。
每个工具的积分成本并非固定。生成前估算成本请使用 OpenAPI 参考 中对应的 */estimate-credits 端点,并用 get_user_subscription 工具查询实时余额。
传输方式
服务器默认以 stdio 运行——这是所有 MCP 客户端(Claude Desktop、Cursor 等)开箱即用的模式。对于远程或共享场景,可改用 HTTP 模式,它同时提供一个可流式(streamable)HTTP 端点(/mcp)和一个 Server-Sent Events 端点(/sse)。详见传输模式。