LPS直播分发管理控制协议服务

LPS MCP 服务是一个面向 LPS 直播分发系统的管理控制协议服务端,兼容新旧两种传输协议。该服务以工程管理为核心,提供工程管理、直播分发、数据分析、拉流管理等能力,并通过统一的 MCP 工具暴露给客户端调用。

  • by cpadyun
  • 更新于

使用说明

基本能力

产品定位

LPS MCP 服务是一个面向 LPS 直播分发系统的管理控制协议服务端,兼容新旧两种传输协议。

核心功能

  • 工程管理:列出、创建、启动、停止、删除、修改、获取详情
  • 分发管理:新增、修改、删除、启停单个分发,批量启停/删除全部分发,获取分发详情
  • 数据分析:获取推流流畅度/帧率/码率历史
  • 拉流管理:设置/删除/查询工程拉流地址
  • 帮助工具:查询模块与操作支持情况

适用场景

  • 直播分发系统的工程管理
  • 直播流的分发与监控
  • 直播数据分析和拉流管理

使用教程

使用依赖

  • Node.js 20+(推荐与 Dockerfile 一致使用 Node 22)
  • NPM 9+ 关键依赖:
  • express
  • @modelcontextprotocol/sdk

安装教程

本地运行:

npm install
npm run start
# 或
node app.js

默认监听端口:8000

MCP服务配置(NPX启动):

{
    "mcpServers": {
        "lps-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "lps-mcp-server"
            ],
            "env": {
                "ACCESS_ID":"<YOUR_ACCESS_ID>",
                "ACCESS_KEY":"<YOUR_ACCESS_KEY>",
            }
        }
    }
}

调试方式

健康检查:

curl -X GET "http://localhost:8000/health"

初始化会话(Streamable HTTP):

curl -i -X POST "http://localhost:8000/mcp?accessId=YOUR_ID&accessKey=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "initialize",
    "params": { "protocolVersion": "2025-03-26" }
  }'

调用工具(示例:获取工程列表):

curl -s -X POST "http://localhost:8000/mcp" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: <SESSION_ID>" \
  -d '{
    "jsonrpc": "2.0",
    "id": "2",
    "method": "tools/call",
    "params": {
      "name": "mlps_mcp_server",
      "arguments": { "module": "project", "operation": "list", "pageSize": 20, "pageIndex": 1 }
    }
  }'

终止会话:

curl -i -X DELETE "http://localhost:8000/mcp" -H "Mcp-Session-Id: <SESSION_ID>"