活动导播台工程 MCP 服务

这是一个用于管理活动导播台工程的 MCP (Model Context Protocol) 服务，提供了完整的 CRUD 操作功能。支持通过 npx 直接运行，无需安装。

✨ 功能特性

• 🎬 创建活动导播台工程 - 创建新的导播台工程
• 🚀 开启活动导播台工程 - 启动指定的导播台工程
• 🛑 关闭活动导播台工程 - 停止指定的导播台工程
• 🗑️ 删除活动导播台工程 - 删除指定的导播台工程
• 📋 获取活动导播台工程列表 - 获取所有工程列表
• 🎛️ 获取活动导播台中控页面 - 获取中控页面访问链接
• 🔐 获取LCPS认证Token - 获取LCPS认证Token
• 📡 设置信道参数 - 批量设置信道参数（视频比例、输入源、缓冲时间）
• 📡 设置输出地址 - 配置导播台输出流参数
• 🔄 信道切换 - 快速切换导播台的信道
• 🎨 切换至指定垫片 - 将指定信道设置成垫片并进行切换
• 🔧 命令行参数支持 - 支持通过参数传入认证信息
• 🌍 环境变量支持 - 支持通过环境变量配置
• 🔐 自动认证 - 支持自动获取和解析认证信息

运行环境

• Node.js 18+
• NPM 9+

依赖（关键）：

• @modelcontextprotocol/sdk
• zod

🚀 快速开始

获取 API 密钥

请参考 奥点云 APAAS 平台 API 密钥获取指南 获取您的 ACCESS_ID 和 ACCESS_KEY。

方法1：使用 npx 直接运行（推荐）

# 使用参数
npx lcps-mcp-server --access-id "<YOUR_ACCESS_ID>" --access-key "<YOUR_ACCESS_KEY>"

# 指定版本运行
npx lcps-mcp-server@1.0.0 --access-id "<YOUR_ACCESS_ID>" --access-key "<YOUR_ACCESS_KEY>"

方法2：全局安装后使用

# 全局安装
npm install -g lcps-mcp-server

# 运行服务
npm lcps-mcp-server --access-id "<YOUR_ACCESS_ID>" --access-key "<YOUR_ACCESS_KEY>"

# 安装指定版本
npm install -g lcps-mcp-server@1.0.0

方法3：本地安装

# 安装依赖
npm install lcps-mcp-server

# 运行服务
npx lcps-mcp-server --access-id "<YOUR_ACCESS_ID>" --access-key "<YOUR_ACCESS_KEY>"

# 安装指定版本
npm install lcps-mcp-server@1.0.0

🌍 环境变量支持

您也可以通过环境变量设置配置：

# Linux/macOS
export ACCESS_ID="<YOUR_ACCESS_ID>"
export ACCESS_KEY="<YOUR_ACCESS_KEY>"

# Windows PowerShell
$env:ACCESS_ID="<YOUR_ACCESS_ID>"
$env:ACCESS_KEY="<YOUR_ACCESS_KEY>"

# Windows CMD
set ACCESS_ID=<YOUR_ACCESS_ID>
set ACCESS_KEY=<YOUR_ACCESS_KEY>

📝 使用示例

查看帮助

npx lcps-mcp-server --help

🔧 MCP 工具说明

1. 创建活动导播台工程

工具名: create_active_lcps_project

参数:

• title (string): 工程标题
• inputNum (number): 信源数目 (4, 5, 6, 7, 8)
• resolution (string): 分辨率 (720p, 1080p)
• useHours (number): 使用时长（小时），默认1小时
• remarks (string, 可选): 备注信息（可选，默认自动生成resolution和inputNum的组合）

功能: 创建新的活动导播台工程，返回工程ID

2. 开启活动导播台工程

工具名: open_active_lcps_project

参数:

• projectId (number): 工程ID
• expiresTime (number): 到期时间（秒级时间戳）

功能: 开启指定的导播台工程，返回LCPS地址

3. 关闭活动导播台工程

工具名: close_active_lcps_project

参数:

• projectId (string): 工程ID

功能: 关闭指定的导播台工程

4. 删除活动导播台工程

工具名: delete_active_lcps_project

参数:

• projectId (string): 工程ID

功能: 删除指定的导播台工程

5. 获取活动导播台工程列表

工具名: get_active_lcps_project_list

参数:

• num (number): 每页数目，默认10，最大100
• page (number): 页数，默认1

返回数据:

• 工程列表详细信息
• 总工程数量
• 每个工程的状态、创建时间等信息

6. 获取活动导播台中控页面

工具名: get_active_lcps_control_page

参数:

• projectId (number): 工程ID

返回数据:

• 中控页面访问链接
• 认证信息（ID和SecretKey）

7. 获取LCPS认证Token

工具名: get_lcps_auth_token

参数:

• id (string): LCPS实例ID
• secretKey (string): LCPS密钥
• pathname (string): 认证路径，默认为"/getToken"
• projectId (number, 可选): 工程ID（用于自动获取认证信息）

功能: 获取LCPS认证Token，支持自动解析认证信息

返回数据:

• 认证Token信息（validate, timestamp, rand）
• 解析出的认证参数

8. 设置信道参数

工具名: set_channel

参数:

• lcpsAddr (string): LCPS地址（支持带http/https协议或不带协议的格式）
• channel (number): 信道号（1-16）
• keepRatio (boolean, 可选): 是否保持视频比例
• playURL (array, 可选): 拉流地址数组
• inputType (string): 输入类型，默认"拉流"
• allowPublishForce (boolean): 是否允许强制发布，默认false
• firstBufferTime (number): 首次缓冲时间（秒），默认0
• maxBufferTime (number): 最大缓冲时间（秒），默认1
• smoothMode (boolean): 平滑模式，默认false
• enableLowLatency (boolean): 启用低延迟，默认false
• id (string, 可选): LCPS实例ID（从get_active_lcps_control_page获取）
• secretKey (string, 可选): LCPS密钥（从get_active_lcps_control_page获取）
• projectId (number, 可选): 工程ID（用于自动获取认证信息）

功能: 一次性设置多个信道参数，包括视频比例、输入源和缓冲时间

支持的lcpsAddr格式:

• http://mcx0emt6-20250710143054-1011.lcps.jstest.aodianyun.cn
• https://mcx0emt6-20250710143054-1011.lcps.jstest.aodianyun.cn
• mcx0emt6-20250710143054-1011.lcps.jstest.aodianyun.cn

执行的操作:

1. 设置视频保持比例（如果提供keepRatio参数）
2. 切换输入源（如果提供playURL参数）
3. 设置缓冲时间（always执行）

9. 设置导播台输出地址

工具名: set_output_address

参数:

• lcpsAddr (string): LCPS地址（从open_active_lcps_project返回的lcpsAddr）
• publishURL (array): 推流地址数组
• formatIndex (number): 格式索引，默认0
• notRestart (boolean): 是否不重启，默认false
• enable (boolean): 是否启用，默认true
• playURL (string): 播放地址，默认为空
• videoSize (string): 视频尺寸，默认"1920x1080"
• videoBitrate (string): 视频码率，默认"3000k"
• videoCBR (boolean): 视频CBR模式，默认false
• qmin (number): 最小量化参数，默认2
• qmax (number): 最大量化参数，默认1024
• gop (number): GOP大小，默认3
• audioBitrate (string): 音频码率，默认"128k"
• audioOnly (boolean): 仅音频模式，默认false
• enableDelayPublish (boolean): 启用延迟发布，默认false
• delayPublishTime (number): 延迟发布时间（秒），默认120
• delayPublishURL (array): 延迟发布地址数组，默认为空
• publishToLPS (boolean): 发布到LPS，默认false
• videoRecord (boolean): 视频录制，默认false
• lossless (boolean): 无损模式，默认false
• hdr (boolean): HDR模式，默认false
• pixfmt (string): 像素格式，默认"yuv420"
• hdrtype (string): HDR类型，默认"HLG"
• id (string, 可选): LCPS实例ID（从get_active_lcps_control_page获取）
• secretKey (string, 可选): LCPS密钥（从get_active_lcps_control_page获取）
• projectId (number, 可选): 工程ID（用于自动获取认证信息）

功能: 配置导播台输出流参数，支持多种编码和发布选项

10. 信道切换

工具名: switch_channel

参数:

• lcpsAddr (string): LCPS地址（从open_active_lcps_project返回的lcpsAddr，支持带http协议）
• channel (number): 信道号（1-16）
• id (string, 可选): LCPS实例ID（从get_active_lcps_control_page获取）
• secretKey (string, 可选): LCPS密钥（从get_active_lcps_control_page获取）
• projectId (number, 可选): 工程ID（用于自动获取认证信息）

功能: 快速切换导播台的信道，支持自动认证

11. 切换至指定垫片

工具名: set_gasket_config

参数:

• lcpsAddr (string): LCPS地址（从open_active_lcps_project返回的lcpsAddr，支持带http协议）
• channel (number): 信道号（1-16）
• url (string): 垫片地址
• title (string, 可选): 垫片标题，默认为"垫片"
• thumbnail (string, 可选): 垫片封面图
• id (string, 可选): LCPS实例ID（从get_active_lcps_control_page获取）
• secretKey (string, 可选): LCPS密钥（从get_active_lcps_control_page获取）
• projectId (number, 可选): 工程ID（用于自动获取认证信息）

功能: 将指定信道设置成垫片并进行切换