LPS MCP 服务（mlps-mcp-server）

一个基于 LPS（直播分发系统）实现的 MCP 服务。

关于LPS

LPS（直播分发系统）的核心功能：支持把客户的推流或拉流分发至任意支持RTMP协议的国内外直播平台，最终实现一处推流处处观看的效果。支持RTMP、SRT、HLS、FLV、WEBRTC等多种直播推流/播放协议。

关于本服务

本服务基于LPS，以"工程"为核心，提供对直播推流、拉流、分发的管理和直播质量数据获取等能力，统一暴露为 MCP 工具以便客户端调用。

运行环境

• Node.js 20+（推荐与 Dockerfile 一致使用 Node 22）
• NPM 9+

依赖（关键）：

• @modelcontextprotocol/sdk
• zod

安装与启动

本地运行

npm install
npm run start
# 或
node app_stdio.js

MCP服务配置(NPX启动)

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

认证

认证信息通过环境变量提供：

• ACCESS_ID：访问ID
• ACCESS_KEY：访问密钥

在启动服务前，请确保设置了这些环境变量。

获取 API 密钥

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

工具列表

🔧 工程管理工具

| 工具名称 | 功能 | 必需参数 | 说明 | |---------|------|----------|------| | project_list | 获取工程列表 | 无 | 支持分页和搜索 | | project_create | 创建工程 | title | 创建新工程 | | project_start | 启动工程 | id + projectId | 需要两个参数 | | project_stop | 停止工程 | id + projectId | 需要两个参数 | | project_delete | 删除工程 | id + projectId | 需要两个参数 | | project_modify | 修改工程 | projectId + title | 修改工程标题 | | project_get_info | 获取工程详情 | projectId | 查询工程信息 |

📡 分发管理工具

| 工具名称 | 功能 | 必需参数 | 说明 | |---------|------|----------|------| | publish_to_add | 添加分发 | projectId + url | 添加分发地址 | | publish_to_modify | 修改分发 | projectId + publishToId + url | 修改分发配置 | | publish_to_remove | 删除分发 | projectId + publishToId | 删除指定分发 | | publish_to_start | 启动分发 | projectId + publishToId | 启动指定分发 | | publish_to_stop | 停止分发 | projectId + publishToId | 停止指定分发 | | publish_to_start_all | 启动所有分发 | projectId | 启动所有分发 | | publish_to_stop_all | 停止所有分发 | projectId | 停止所有分发 | | publish_to_remove_all | 删除所有分发 | projectId | 删除所有分发 | | publish_to_get_detail | 获取分发详情 | projectId | 获取分发详情 |

📊 数据分析工具

| 工具名称 | 功能 | 必需参数 | 说明 | |---------|------|----------|------| | analytics_fluency_history | 获取流畅度历史 | projectId | 推流流畅度数据 | | analytics_fps_history | 获取帧率历史 | projectId | 推流帧率数据 | | analytics_bitrate_history | 获取码率历史 | projectId | 推流码率数据 |

🔄 拉流管理工具

| 工具名称 | 功能 | 必需参数 | 说明 | |---------|------|----------|------| | pull_stream_set | 设置拉流地址 | projectId + url | 设置拉流地址 | | pull_stream_remove | 删除拉流地址 | projectId | 删除拉流地址 | | pull_stream_get | 查询拉流地址 | projectId | 查询拉流地址 |

ℹ️ 其他工具

| 工具名称 | 功能 | 必需参数 | 说明 | |---------|------|----------|------| | about | 获取工具相关信息 | 无 | 工具相关信息 |

重要参数说明

关键参数关系

• id: 平台分配ID，用于工程操作时标识具体工程
• projectId: 工程ID，用于标识工程

参数组合要求

⚠️ 特别注意: 启动/停止/删除工程时需要同时提供 id 和 projectId 两个参数

使用示例

创建并启动工程

// 步骤1: 创建工程
{
  "name": "project_create",
  "arguments": {
    "title": "我的直播工程"
  }
}

// 步骤2: 获取工程列表（获取id和projectId）
{
  "name": "project_list",
  "arguments": {}
}

// 步骤3: 启动工程（需要同时提供id和projectId）
{
  "name": "project_start",
  "arguments": {
    "id": "从步骤2获取的id值",
    "projectId": "从步骤2获取的projectId值"
  }
}

添加分发地址

{
  "name": "publish_to_add",
  "arguments": {
    "projectId": "工程ID",
    "url": "rtmp://example.com/live/stream",
    "serviceName": "example",
    "liveName": "stream"
  }
}

详细文档

• 📋 工具列表详情 - 每个工具的详细说明
• 📖 参数使用指南 - 参数使用方法和最佳实践

常见问题

Q: 为什么启动工程时需要同时提供id和projectId？

A: 这是系统设计的要求：

• projectId 用于标识具体的工程
• id 是平台分配的唯一标识符
• 两个参数配合使用确保操作的准确性和安全性

Q: 如何获取正确的参数值？

A:

1. 使用 project_list 工具获取工程列表
2. 从返回结果中提取 id 和 projectId 字段
3. 在后续操作中同时使用这两个值