LiquidSoapMCP

LiquidSoapMCP is an MCP server that provides version-accurate Liquidsoap 2.4.0 documentation, examples, and API references to AI assistants. You can interact with it using the Core Tools exposed by the server, such as get_version, get_documentation(section), search_functions(query), get_changelog, get_examples(topic), and validate_script_syntax(script). The server is designed to keep LIQ scripts aligned with Liquidsoap 2.4.0, helping you generate correct code, detect deprecated functions, and explore operators, transitions, and patterns. When integrated with an AI assistant, you can query it to explain scripts, fetch specific function references, or validate syntax before execution, reducing hallucinations and version drift. Typical use involves sending requests to the MCP API endpoints to retrieve documentation, examples, and validation results, then incorporating the returned content into your editor, IDE, or chat-based workflow.

Prerequisites:

• Node.js 18 or newer
• A machine or environment where MCP servers are allowed to run

Install via npm (recommended):

npm install -g liquidsoap-mcp-server

Or run from source:

git clone https://github.com/splinesreticulating/LiquidSoapMCP.git
cd LiquidSoapMCP
npm install
npm run build

Run the server (example):

npx -y liquidsoap-mcp-server

If you want to run from source after building:

node build/index.js

For Docker deployment (alternative):

# Build the image
docker build -t liquidsoap-mcp-server .
# Run the container
docker run -i --rm liquidsoap-mcp-server

Tips and notes:

• The server focuses on Liquidsoap 2.4.0 documentation and APIs; avoid mixing 1.x syntax when querying results.
• Core tools include get_version, list_sections, get_documentation(section), and validate_script_syntax(script); use them to build robust prompts for your AI assistant.
• If you plan to run in a production environment, consider paring down network access and enabling caching per the docs to keep responses fast.
• When upgrading Liquidsoap in your deployment, verify that the MCP server you use targets 2.4.0 to prevent drift.
• The npm package name (if using npm installation) is liquidsoap-mcp-server; you can update or pin specific versions as needed.