live_streaming_get_play_urls

Retrieve FLV, M3U8, and WHEP playback URLs to access live streams from Qiniu Cloud's live streaming service.

Instructions

Get playback URLs for a stream. Returns FLV, M3U8, and WHEP playback URLs that can be used to play live streams.

Input Schema

TableJSON Schema

Name	Required	Description
`play_domain`	Yes	The playback domain name
`bucket`	Yes	LiveStreaming bucket name
`stream_name`	Yes	The stream name

Implementation Reference

src/mcp_server/core/live_streaming/tools.py:173-175 (handler)
The async handler function for the MCP tool 'live_streaming_get_play_urls' that delegates to LiveStreamingService.get_play_urls and returns the result as TextContent.
```
async def get_play_urls(self, **kwargs) -> list[types.TextContent]:
    result = self.live_streaming.get_play_urls(**kwargs)
    return [types.TextContent(type="text", text=str(result))]
```

src/mcp_server/core/live_streaming/tools.py:149-172 (schema)

The tool metadata decorator defining the schema, name, description, and input validation for 'live_streaming_get_play_urls'.

@tools.tool_meta(
    types.Tool(
        name="live_streaming_get_play_urls",
        description="Get playback URLs for a stream. Returns FLV, M3U8, and WHEP playback URLs that can be used to play live streams.",
        inputSchema={
            "type": "object",
            "properties": {
                "play_domain": {
                    "type": "string",
                    "description": "The playback domain name",
                },
                "bucket": {
                    "type": "string",
                    "description": _BUCKET_DESC,
                },
                "stream_name": {
                    "type": "string",
                    "description": "The stream name",
                },
            },
            "required": ["play_domain", "bucket", "stream_name"],
        },
    )
)

src/mcp_server/core/live_streaming/tools.py:242-257 (registration)

The registration function that creates a tool implementation instance and auto-registers all LiveStreaming tools, including 'live_streaming_get_play_urls'.

def register_tools(live_streaming: LiveStreamingService):
    tool_impl = _ToolImpl(live_streaming)
    tools.auto_register_tools(
        [
            tool_impl.create_bucket,
            tool_impl.create_stream,
            tool_impl.bind_push_domain,
            tool_impl.bind_play_domain,
            tool_impl.get_push_urls,
            tool_impl.get_play_urls,
            tool_impl.query_live_traffic_stats,
            tool_impl.list_buckets,
            tool_impl.list_streams,
        ]
    )

src/mcp_server/core/live_streaming/live_streaming.py:311-337 (helper)

The core implementation in LiveStreamingService that generates the FLV, M3U8, and WHEP playback URLs using string formatting.

def get_play_urls(self, play_domain: str, bucket: str, stream_name: str) -> Dict[str, Any]:
    """
    Generate playback URLs for FLV, M3U8, and WHEP protocols

    Args:
        play_domain: The playback domain
        bucket: The bucket name
        stream_name: The stream name

    Returns:
        Dict containing FLV, M3U8, and WHEP playback URLs
    """
    flv_url = f"https://{play_domain}/{bucket}/{stream_name}.flv"
    m3u8_url = f"https://{play_domain}/{bucket}/{stream_name}.m3u8"
    whep_url = f"https://{play_domain}/{bucket}/{stream_name}.whep"

    logger.info(f"Generated playback URLs for stream: {stream_name}")
    return {
        "status": "success",
        "play_domain": play_domain,
        "bucket": bucket,
        "stream_name": stream_name,
        "flv_url": flv_url,
        "m3u8_url": m3u8_url,
        "whep_url": whep_url,
        "message": "Playback URLs generated successfully"
    }

Qiniu MCP Server