MCP Server Product Name:

Live MCP Server

Version Information

v1

Product Description

The MCP Server provided by Volcengine Live offers powerful query capabilities, supporting natural language dialogue interactions to implement various API calls for data querying, URL generation, troubleshooting, and more, facilitating workflow construction with large language models.

Category

Enterprise Application

Tags

Live Streaming

Tools

This MCP Server provides the following tools/capabilities:

Tool1: list_domain_detail

• Description: Query paginated domain list information under the account
• Trigger Example: Call ListDomainDetail interface to query domain list information under current account based on domain status and category.

Tool2: describe_domain

• Description: Query detailed information of a specific domain
• Trigger Example: Call DescribeDomain interface to query domain details including domain namespace, CNAME, type, and status.

Tool3: generate_push_url

• Description: Generate live streaming push URLs based on parameters including Vhost, Domain, App, Stream, and ValidDuration.
• Example: Invoke the GeneratePushURL interface to create live streaming push addresses.

Tool4: generate_play_url

• Description: Generate live streaming pull URLs based on parameters including Domain, App, Stream, Type, Suffix, and ValidDuration.
• Example: Use the GeneratePlayURL interface to produce live streaming playback addresses.

Tool5: describe_live_stream_count_data

• Description: Query statistical information of live streaming data within specified time ranges.
• Example: Call DescribeLiveStreamCountData to retrieve peak counts of push streams, back-to-source streams, or transcoded streams.

Tool6: describe_live_batch_stream_traffic_data

• Description: Obtain upstream/downstream traffic metrics and detailed data for specified time periods.
• Example: Utilize DescribeLiveBatchStreamTrafficData to analyze traffic patterns across multiple streams.

Tool7: describe_live_stream_session_data

• Description: Retrieve request counts and peak concurrent users for live streams.
• Example: Employ DescribeLiveStreamSessionData to monitor viewer engagement metrics.

Tool8: describe_live_push_stream_metrics

• Description: Monitor audio/video frame rates and bitrates for individual push streams.
• Example: Implement DescribeLivePushStreamMetrics for real-time stream health checks.

Tool9: describe_ip_info

• Description: Verify CDN node attribution and obtain regional/ISP details for IP addresses.
• Example: Check DescribeIpInfo to validate Volcano Engine CDN node status.

Tool10: describe_live_push_stream_info_data

• Description: Investigate disconnected push streams and termination causes.
• Example: Analyze DescribeLivePushStreamInfoData for stream interruption diagnostics.

Tool11: describe_live_transcode_info_data

• Description: Access detailed transcoding job records including timelines and configurations.
• Example: Query DescribeLiveTranscodeInfoData for transcoding operation audits.

Tool12: describe_live_top_play_data

• Description: Use this API to retrieve traffic and bandwidth metrics for TopN live streams or TopN domains.
• Example: Invoke DescribeLiveTopPlayData API to query traffic and bandwidth information of TopN live streams/domains within specified time ranges.

Most Frequently Used Prompt Examples

list_domain_detail

List the first 10 domain information under the current account.

describe_domain

Query detailed information for the domain xxx.xxx.com

describe_live_stream_session_data

Help me check the number of online users of the XXX domain name today.

describe_live_push_stream_info_data

Check the streaming information of the xxx domain name today. The app is xx and the stream name is xx. Also, list the reasons for the stream disconnection.

Supported Platforms

Compatible with cline, cursor, Trae, claude desktop or other terminals supporting MCP server invocation

Service Activation Link (Full Product Suite)

https://console.volcengine.com/live

Authentication Method

Obtain Volcengine Access Key ID, Secret Access Key, and Region from the Volcengine Management Console

Installation & Deployment

System Requirements

• Install Python 3.10 or higher
• Install uv
  • For Linux systems:

  curl -LsSf https://astral.sh/uv/install.sh | sh

  • For Windows systems:

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  • Synchronize dependencies and update uv.lock:

  uv sync

  • Build the MCP server:

  uv build

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run mcp-server-live.

Local Configuration

• Add the following configuration to your mcp settings file

{
    "mcpServers": {
      "mcp-live": {
        "command": "uv",
        "args": [
          "--directory",
          "/ABSOLUTE/PATH/TO/PARENT/mcp_server_live/src/live",
          "run",
           "mcp-server-live"
        ],
        "env": {
          "VOLCENGINE_ACCESS_KEY": "your access-key-id",
          "VOLCENGINE_SECRET_KEY": "your access-key-secret",
          "VOLCENGINE_REGION": "your region"
        }
      }
    }
  }

OR

• Add the following configuration to your mcp settings file

{
  "mcpServers": {
    "mcp-live": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/mcp_server_live/src/live",
        "run",
        "server.py"
      ],
      "env": {
        "VOLCENGINE_ACCESS_KEY": "your access-key-id",
        "VOLCENGINE_SECRET_KEY": "your access-key-secret",
        "VOLCENGINE_REGION": "your region"
      }
    }
  }
}

Using uvx

Local Configuration

• Add the following configuration to your mcp settings file

{
  "mcp-server": {
    "mcp-live": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_live",
        "mcp-server-live"
      ],
      "env": {
        "VOLCENGINE_ACCESS_KEY": "your access-key-id",
        "VOLCENGINE_SECRET_KEY": "your access-key-secret",
        "VOLCENGINE_REGION": "your region"
      }
    }
  }
}

or

{
  "mcpServers": {
    "mcp-live": {
      "command": "uvx",
      "args": [
        "--from",
        "/ABSOLUTE/PATH/TO/PARENT/mcp-server/server/mcp_server_live",
        "mcp-server-live"
      ],
      "env": {
        "VOLCENGINE_ACCESS_KEY": "your access-key-id",
        "VOLCENGINE_SECRET_KEY": "your access-key-secret",
        "VOLCENGINE_REGION": "your region"
      },
    }
  }
}

License

MIT