LiquidSoap

You can run the LiquidSoap MCP Server to give AI assistants accurate Liquidsoap 2.4.0 documentation, examples, and API references. This makes it safe for you to generate correct code, detect deprecated usage, and build reliable streaming pipelines with confidence.

How to use

Run the MCP server locally or in a container and connect your MCP client to it. You’ll be able to query version-pinned Liquidsoap 2.4.0 references, search functions and operators by name or topic, check changelog notes, and validate or improve your Liquidsoap scripts. Use the server to explain scripts, fetch 2.4.0 docs for operators like crossfade, and rewrite fragments to match Liquidsoap 2.4.0 conventions. The server’s responses stay aligned with Liquidsoap 2.4.0, so you won’t encounter drift or outdated examples.

Typical usage patterns include:

• Ask for what a script does and get a strict 2.4.0 explanation.
• Add or adjust a pipeline; have the server validate syntax and suggest fixes for deprecated functions.
• Retrieve documentation for a specific section such as languages, protocols, or encoding formats, and reuse the snippets directly in your scripts.

How to install

Prerequisites

• Node.js 18 or newer
• An MCP-compatible client to connect to the server
• Optional: Docker if you prefer containerized usage

# Install the MCP server globally (recommended)
npm install -g liquidsoap-mcp-server

Usage notes and examples

You can run the server in several ways. Each method runs the MCP server as its own process and exposes an MCP connection you can connect to from your AI assistant.

Examples shown here reflect common, explicitly labeled MCP commands. If you see an entry labeled for an MCP runtime, use that exact command.

Additional content

Configuration snippets below show how to start the MCP server in different environments. Use the snippet that matches your setup.

{
  "mcpServers": {
    "liquidsoap": {
      "command": "npx",
      "args": ["-y", "liquidsoap-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "liquidsoap": {
      "command": "node",
      "args": ["/absolute/path/to/LiquidSoapMCP/build/index.js"]
    }
  }
}

{
  "mcpServers": {
    "liquidsoap": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "liquidsoap-mcp-server"]
    }
  }
}

Available tools

get_version

Returns the current version of the MCP server or the underlying Liquidsoap tooling.

list_sections

Lists all documentation sections available through the MCP server.

get_documentation

Fetches documentation for a specific Liquidsoap topic or section.

search_functions

Searches for functions or operators by name or keyword.

get_changelog

Retrieves the 2.4.0 changelog and migration notes.

get_examples

Provides ready-to-use examples and patterns from the example library.

validate_script_syntax

Validates Liquidsoap scripts for syntax and compatibility with 2.4.0.