Listenhub MCP Server

🚀 ListenHub MCP Server

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

  # インストールが成功した後、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. 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マーケットプレイスから 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構成モジュールに以下の情報を入力します。
     • Command: 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人のスピーカーをサポートし、ボイスをカスタマイズ可能
  • 複数の生成モード：Quick Listen、Deep Exploration、Debate
  • 二段階生成をサポート
  • テキストとURLのコンテンツソースをサポート
  • ポッドキャストの生成ステータスを照会
  • 音声ファイル、タイトル、スクリプト、アウトラインにアクセス
  • クレジット消費を追跡
• FlowSpeech音声生成
  • テキストまたはURLからの書き込みコンテンツを単一スピーカーの会話音声に変換
  • Smartモード（AI強化読み上げ）またはDirectモード（そのまま読み上げ）をサポート
  • 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 Streaming: http://localhost:3000/mcp
• Server-Sent Events: 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 - 既存のテキストコンテンツを持つポッドキャストの音声を生成します。二段階生成の2番目の段階です。
  • episodeId: ポッドキャストID（文字列、必須）
  • customScripts: カスタムスクリプトの配列（配列、オプション）
  • waitForCompletion: 生成が完了するまで待つ（ブール値、オプション、デフォルト: true）

FlowSpeech生成

• create_flowspeech - テキストまたはURLのコンテンツを音声に変換し、FlowSpeechを作成します。Smartモード（AI強化）とDirectモード（変更なし）をサポートします。
  • 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