Listenhub MCP Server

🚀 ListenHub MCP Server

ListenHub MCP Server是ListenHub的官方MCP服務器，支持AI播客生成（單播或雙播）、FlowSpeech創建等功能。此服務僅對ListenHub專業版及以上套餐用戶開放。

English | 簡體中文

🚀 快速開始

環境配置

安裝Node.js

此服務器需要Node.js 18或更高版本。若您尚未安裝Node.js，請按以下說明操作：

• macOS系統 方法一：使用官方安裝程序

  1. 訪問 Node.js官方網站，下載Node.js長期支持版本，例如 v24.11.0(LTS)。
  2. 打開下載的 .pkg 文件，按照安裝嚮導完成安裝。
  3. 打開終端，運行以下命令驗證安裝：

  node --version
  npm --version
  

  方法二：使用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. 訪問 Node.js官方網站。
  2. 下載適用於Windows的LTS（長期支持）版本。
  3. 運行下載的 .msi 安裝程序。
  4. 按照安裝嚮導完成安裝。
  5. 打開PowerShell，運行以下命令驗證安裝：

  node --version
  npm --version
  

  方法二：使用winget（Windows包管理器） 若您使用的是Windows 10 1809或更高版本：

  winget install OpenJS.NodeJS.LTS
  

  然後驗證安裝：

  node --version
  npm --version
  

  方法三：使用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密鑰。

💻 使用示例

基礎用法

生成英文播客

✨ 主要特性

• 播客生成：
  • 支持全量生成（文本 + 音頻）或僅生成文本。
  • 支持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：源類型 - 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 Server！

若您有任何疑問，請隨時聯繫我們：support@marswave.ai