ListenHub MCP

クイックスタート

Node.js をインストールし、API キーを取得して、ListenHub MCP server をクライアントに接続します。

ListenHub は、AI ポッドキャスト生成（1 人または 2 人のホスト）、FlowSpeech ナレーション、および関連機能に対応した公式 MCP server を提供しています。

MCP server は、API キーを持つすべての ListenHub ユーザーが利用できます。API キーはどの ListenHub アカウントでも自動的に生成されるため、server に接続するためのプラン条件はありません。ポッドキャスト、FlowSpeech、音声の生成は、プランに応じてクレジットを消費します。生成前に残高を確認して消費量を見積もるには、get_user_subscription ツール、または */estimate-credits エンドポイント を使用してください。

クイックスタート

環境設定

まず Node.js をインストールします。

MCP server は Node.js 18 以降を必要とします。Node.js がまだインストールされていない場合は、以下のいずれかの方法で導入してください。

  • macOS

    方法 1：公式インストーラー

    1. Node.js 公式サイト にアクセスし、LTS リリースをダウンロードする（例：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)"

    続いて 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 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 を実際の API キーに置き換えてください。

  • Cursor

    1. Cursor Settings を開く
    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 を実際の API キーに置き換えてください。

    任意：HTTP トランスポートモード

    server を手動で起動します：

    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 Settings を開く
    2. MCP Servers に移動する
    3. 新しい server 設定を追加する

    設定ファイルの場所：

    • 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 を実際の API キーに置き換えてください。

  • VS Code（Cline 拡張機能を使用）

    1. VS Code Marketplace から Cline 拡張機能 をインストールする
    2. VS Code Settings を開く
    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 を実際の API キーに置き換えてください。

  • Zed

    1. Zed Settings を開く
    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 を実際の 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> を実際の 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> を実際の API キーに置き換えてください。

  • ChatWise

    1. ChatWise の設定を開き、MCP を選択して + をクリックし、新しい MCP サービスを追加する
    2. MCP の設定項目を入力する：

    ChatWise の MCP 設定

    • Command：npx -y @marswave/listenhub-mcp-server@latest
    • Run tools automatically を有効にする
    • 環境変数 LISTENHUB_API_KEY を追加し、値に自分のキーを設定する
    1. チャット入力エリアからツールを有効にして使い始める

  • その他の 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 を実際の API キーに置き換えてください。

次のステップ

使用例

よくあるフローについて、プロンプトからツール呼び出しまでの手順を解説。

利用可能なツール

8 つの MCP ツールの入力、制約、レスポンス構造。

MCP Server

ListenHub の音声生成を、Claude Desktop や Cursor などの MCP クライアント内で MCP ツールとして利用できます。

使用例

ポッドキャスト、FlowSpeech、台本先行フロー、話者の検索、アカウント確認について、プロンプトからツール呼び出しまでを解説します。

このページの内容

クイックスタート環境設定クライアント別の設定方法次のステップ