mvf1

A Python package and command line interface to control video players for MultiViewer For F1, the best way to watch Formula 1.

python

18

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "robspectre-mvf1": {
      "command": "mvf1-cli",
      "args": [
        "mcp"
      ]
    }
  }
}

You can control MultiViewer video players programmatically and via a dedicated MCP server. This MCP server lets you manage and automate video playback, mute states, stream switching, and synchronization across all players, making it ideal for AI agents, control surfaces, or scripted broadcast workflows.

How to use

You interact with the MCP server by connecting through a stdio channel. Run the MCP server from the command line and then use your MCP client to send commands. The server exposes actions for listing players, muting, inspecting state, switching streams, and synchronizing playback across all players.

How to install

Prerequisites: Python 3.8+ and a working Python package manager.

Install the mvf1 package from PyPI using pip.

Run the MCP server with the provided stdio command to enable AI agent usage.

Additional usage notes

You can display all players, pause or mute them, retrieve individual player state, switch a player's stream to a data channel, and synchronize all players to a specific broadcast source. These actions help automate and orchestrate a broadcast, especially when integrating with AI agents or external control surfaces.

For example, you can access the list of players, inspect a particular player’s state, and perform a synchronization operation to align all players with a chosen source.

Available tools

list_players

Retrieve the full list of active players and their basic metadata so you can target specific players for further actions.

mute_player

Mute a specific player or all players to silence audio during a broadcast.

get_player_state

Fetch the current state of a single player, including time, mute status, volume, and live/currentTime values.

switch_stream

Switch the data stream for a given player to a different channel, such as DATA or a dedicated streaming path.

sync_players

Synchronize all players to a chosen source or broadcast timing to ensure cohesive playback across the set.

sync_to_commentary

Synchronize all players to the broadcasting commentary stream for synchronized narration.