MCP server for LiquidSoap 2.4.0 documentation and script assistance
概览
LLMs get Liquidsoap wrong a lot. Mixing 1.x docs, outdated blog posts, and half-remembered API examples. It gives your AI assistant (Claude, ChatGPT, Cursor, Windsurf, etc.) , making it finally possible to: - Understand .liq scripts - Generate correct 2.4.0 code - Fix errors and deprecated usage - Explore operators, functions, transitions, and patterns - Build web radio pipelines with confidence No hallucinations. No version drift. No mystery errors. - Documentation varies heavily between versions - 1.x and 2.x syntax differs in subtle ways - LLMs blend outdated examples into their answers - Even the official docs are spread across sections, pages, and changelogs It exposes a clean, structured API around the official docs so your assistant becomes a reliable Liquidsoap expert. - Full language reference - Core API functions & operators - Protocols (Icecast, HLS, HTTP, SRT, etc.
README
以下为原文 README 节选，完整内容请查看原文。
LiquidSoap MCP Server
Version-accurate Liquidsoap scripting using the official 2.4.0 docs.
LLMs get Liquidsoap wrong a lot. Mixing 1.x docs, outdated blog posts, and half-remembered API examples.
This MCP server fixes that.
It gives your AI assistant (Claude, ChatGPT, Cursor, Windsurf, etc.) real Liquidsoap 2.4.0 documentation, examples, and API references, making it finally possible to:
- Understand
.liqscripts - Generate correct 2.4.0 code
- Fix errors and deprecated usage
- Explore operators, functions, transitions, and patterns
- Build web radio pipelines with confidence
No hallucinations. No version drift. No mystery errors.
Why this exists
Liquidsoap is incredibly powerful, but:
- Documentation varies heavily between versions
- 1.x and 2.x syntax differs in subtle ways
- LLMs blend outdated examples into their answers
- Even the official docs are spread across sections, pages, and changelogs
This MCP server gives your AI one job:
Stick to Liquidsoap 2.4.0 exactly.
It exposes a clean, structured API around the official docs so your assistant becomes a reliable Liquidsoap expert.
Features
Version-Pinned Documentation (2.4.0)
- Full language reference
- Core API functions & operators
- Protocols (Icecast, HLS, HTTP, SRT, etc.)
- Encoder/decoder options
- Runtime settings
Smart Search
- Search functions/operators by name or keyword
- Search through examples, patterns, and cookbook items
- Search 2.4.0 changelog & migration notes
Script Assistance
- Detect deprecated functions (e.g.
null(),insert_metadata) - Warn about 1.x syntax
- Highlight common design pitfalls
Example Library
Ready-to-use snippets:
- Crossfading
- Fallback chains
安装
npx -y liquidsoap-mcp-server配置
{
"mcpServers": {
"liquidsoap": {
"command": "npx",
"args": ["-y", "liquidsoap-mcp-server"]
}
}
}