快速开始

安装 Node.js、获取 API key，并将 ListenHub MCP server 接入你的客户端。

ListenHub 提供官方 MCP server，支持 AI 播客生成（单人或双人）、FlowSpeech 旁白及相关能力。

MCP server 面向所有拥有 API key 的 ListenHub 用户开放。任何 ListenHub 账号都会自动生成 API key，连接 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

# 安装 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 key。

在 ListenHub API key 设置页创建或查看 API key，然后将其设为环境变量 LISTENHUB_API_KEY。请将 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 key。

Cursor

打开 Cursor Settings
进入 Features -> Model Context Protocol
点击 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 key。

可选：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

打开 Windsurf Settings
进入 MCP Servers
添加新的 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 key。

VS Code（搭配 Cline 扩展）

从 VS Code Marketplace 安装 Cline 扩展
打开 VS Code Settings
搜索 Cline: MCP Settings
点击 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 key。

Zed

打开 Zed Settings
进入 MCP 部分
编辑配置文件

配置文件位置：

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 key。

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 key。

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 key。

ChatWise
1. 打开 ChatWise 设置，选择 MCP，点击 + 添加新的 MCP 服务
2. 填写 MCP 配置字段：
- Command：npx -y @marswave/listenhub-mcp-server@latest
- 启用 Run tools automatically
- 添加环境变量 LISTENHUB_API_KEY，值为你的 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 key。

快速开始

快速开始

环境配置

各客户端配置方式

下一步

使用示例

可用工具

On this page