STARWARCLOUD STARWAR.AI
返回市场
监听中心-mcp服务器

监听中心-mcp服务器

作者：marswaveai7 星标更新：2025-11-17
安装使用来源：spider==github.com

项目介绍

技术文档摘要

<h1 align="center">ListenHub MCP 服务器</h1>

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

<p align="center"> <a href="https://listenhub.ai"><img alt="ListenHub 网站" 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 版本" 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="许可证" 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>

快速开始

环境配置

安装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)"

    # 成功安装后，使用brew下载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 
    # 安装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 
    # 安装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. 导航到功能→模型上下文协议
    3. 点击添加MCP服务器或直接编辑配置文件 配置文件位置：
    • 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服务器部分
    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市场安装Cline扩展
    2. 打开VS Code设置
    3. 搜索"Cline: 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 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密钥。

使用示例

生成英文播客

image.png

核心功能

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

传输模式

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

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: 来源类型 - text或url（字符串，必需）
    • sourceContent: 来源内容（文本或URL）（字符串，必需）
    • speakerId: 叙述者的发言人ID（字符串，必需）
    • language: 语言代码 - zh或en（字符串，可选）
    • mode: 生成模式 - smart或direct（字符串，可选，默认：smart）
  • get_flowspeech_status - 查询FlowSpeech的详细信息。立即返回当前状态，无需轮询。
    • episodeId: FlowSpeech ID（字符串，必需）

用户账户查询

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

感谢您使用ListenHub MCP服务器！

如有任何问题，请随时联系我们：support@marswave.ai