SL

splinesreticulating/liquidsoapmcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

6 stars 4 forks Качество 70 Тренд 14MIT

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 .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.


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
  • 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
Открыть полный README на GitHub

Установка

npx -y liquidsoap-mcp-server
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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