Listenhub Mcp Server

ListenHub MCP サーバー

ListenHub の公式 MCP サーバーです。AI ポッドキャストの生成（単独またはデュアルスピーカー）、FlowSpeech の作成などに対応しています。ListenHub Pro プラン以上で利用できます。

英語 | 简体中文

クイックスタート

環境設定

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 Package Manager）を使用 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 Extension 経由）
  1. VS Code Marketplace から Cline Extension をインストールします
  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
     • 環境変数：値に API キーを指定して LISTENHUB_API_KEY を追加します
  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人の話者に対応
  • 複数の生成モード：クイックリスニング、詳細な探索、ディベート
  • 2段階生成に対応
  • テキストおよび URL のコンテンツソースに対応
  • ポッドキャスト生成状況の照会
  • 音声ファイル、タイトル、台本、概要へのアクセス
  • クレジット消費量の追跡
• FlowSpeech 音声生成：
  • テキストまたは URL の文章コンテンツを、1人の話者による会話形式の音声に変換
  • スマートモード（AI による読み上げの強化）またはダイレクトモード（原文どおりの読み上げ）に対応
  • FlowSpeech の生成状況の照会
  • 音声ファイル、タイトル、台本、概要へのアクセス
  • クレジット消費量の追跡
• 話者管理：
  • 利用可能な話者／音声ライブラリの閲覧
  • 言語と話者属性による絞り込み
  • 話者 ID、名前、言語、性別、デモ音声の取得
• ユーザーアカウント管理：
  • サブスクリプションのステータスとプラン情報の照会
  • クレジット使用状況の確認：月間クレジット、恒久クレジット、期間限定クレジット
  • 利用可能なクレジットの合計と更新状況の確認
  • サブスクリプションの開始日と有効期限の確認
• 複数のトランスポートモード：柔軟な統合のため、Stdio、HTTP SSE、HTTP Streamable のトランスポート方式に対応

トランスポートモード

このサーバーは、さまざまな用途に対応するため、複数のトランスポートモードをサポートしています。

Stdio モード（デフォルト）

標準入力／出力による通信です。ほとんどの MCP クライアント（Claude Desktop、Cursor など）で使用されるデフォルトのモードです。

上記の設定例はすべてデフォルトで Stdio モードを使用するため、追加の設定は不要です。

HTTP/SSE モード

高度な用途では、サーバーを HTTP モードで実行できます。このモードでは、HTTP ストリーミングと Server-Sent Events（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
• Server-Sent Events：http://localhost:3000/sse

HTTP エンドポイントを使用するように MCP クライアントを設定します：

{
  "mcpServers": {
    "listenhub": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

利用可能なツール

話者の照会

• get_speakers - ポッドキャスト生成で利用可能な話者の一覧を取得します。話者 ID、名前、言語、性別、デモ音声のリンクが返されます。
  • language：言語コード（zh/en）で絞り込みます（string、任意）

ポッドキャスト生成

• create_podcast - 完全生成（テキスト＋音声）でポッドキャストを作成します。1～2人の話者に対応します。完了するまで自動的にポーリングします（数分かかる場合があります）。
  • query：コンテンツまたはトピック（string、任意）
  • sources：テキスト／URL ソースの配列（array、任意）
  • speakerIds：1～2人の話者 ID の配列（array、必須）
  • language：言語コード - zh または en（string、任意、デフォルト：en）
  • mode：生成モード - quick、deep、または debate（string、任意、デフォルト：quick）
• get_podcast_status - ポッドキャストの詳細情報を照会します。ポーリングせずに現在のステータスをすぐに返します。
  • episodeId：ポッドキャスト ID（string、必須）
• create_podcast_text_only - テキストコンテンツのみ（音声なし）でポッドキャストを作成します。2段階生成の第1段階です。
  • query：コンテンツまたはトピック（string、任意）
  • sources：テキスト／URL ソースの配列（array、任意）
  • speakerIds：1～2人の話者 ID の配列（array、必須）
  • language：言語コード - zh または en（string、必須）
  • mode：生成モード - quick、deep、または debate（string、任意、デフォルト：quick）
  • waitForCompletion：生成完了まで待機するかどうか（boolean、任意、デフォルト：true）
• generate_podcast_audio - 既存のテキストコンテンツを使用して、ポッドキャストの音声を生成します。2段階生成の第2段階です。
  • episodeId：ポッドキャスト ID（string、必須）
  • customScripts：カスタム台本の配列（array、任意）
  • waitForCompletion：生成完了まで待機するかどうか（boolean、任意、デフォルト：true）

FlowSpeech の生成

• create_flowspeech - テキストまたは URL のコンテンツを音声に変換し、FlowSpeech を作成します。Smart モード（AI による拡張）と Direct モード（変更なし）に対応しています。
  • sourceType: ソースの種類（text または url）（string、必須）
  • sourceContent: ソースの内容（テキストまたは URL）（string、必須）
  • speakerId: ナレーションの話者 ID（string、必須）
  • language: 言語コード（zh または en）（string、任意）
  • mode: 生成モード（smart または direct）（string、任意、デフォルト：smart）
• get_flowspeech_status - FlowSpeech の詳細情報を照会します。ポーリングせずに現在のステータスをすぐに返します。
  • episodeId: FlowSpeech ID（string、必須）

ユーザーアカウント情報の照会

• get_user_subscription - 現在のユーザーのサブスクリプション情報を取得します。サブスクリプションのステータス、クレジットの使用状況、プランの詳細、更新状況が含まれます。

---

ListenHub MCP Server をご利用いただき、ありがとうございます！

ご質問がございましたら、お気軽にお問い合わせください：[email protected]