Liquid Soap MCP

](https://mseep.ai/app/splinesreticulating-liquidsoapmcp)


LiquidSoap MCP服务器

*使用官方2.4.0文档进行版本精确的Liquidsoap脚本编写。*

LLMs经常弄错Liquidsoap。混合了1.x文档、过时的博客文章和记不清的API示例。

此MCP服务器修复了此问题。

它为您的AI助手（Claude、ChatGPT、Cursor、Windsurf等） real Liquidsap 2.4.0文档、示例和API参考资料，最终可以：

• 理解 .liq 脚本
• 生成正确的2.4.0代码
• 修复错误和不推荐使用
• 探索运算符、函数、转换和模式
• 自信地建立网络广播管道

没有幻觉。没有版本漂移。没有神秘的错误。

______________________________________________________________________

为什么存在

Liquidsoap非常强大，但是：

• 不同版本的文档差异很大
• 1.x和2.x语法在细微之处有所不同
• 法学硕士在他们的答案中融入了过时的例子
• 甚至官方文档也分散在各个部分、页面和变更日志中

此MCP服务器为您的AI提供了一项任务：\ *严格遵守Liquidsoap 2.4.0。*

它围绕官方文档公开了一个干净、结构化的API，因此您的助手将成为一名可靠的Liquidsap专家。

______________________________________________________________________

特性

版本固定文档（2.4.0）

• 完整语言参考
• API核心函数和运算符
• 协议（Icecast、HLS、HTTP、SRT等）
• 编码器/解码器选项
• 运行时设置

智能搜索

• 按名称或关键字搜索功能/运算符
• 搜索示例、模式和烹饪书项目
• 搜索2.4.0更新日志和迁移说明

脚本辅助

• 检测已弃用的功能（例如。 null(), insert_metadata)
• 关于1.x语法的警告
• 突出常见的设计陷阱

示例库

即用型代码片段：

• 交叉淡入淡出
• 倒链
• 港口实时输入
• HLS输出
• Cron调度(cron.add, cron.parse)
• 元数据重写
• LUFS标准化
• 空白检测
• 多输出管道

快速和本地

• 缓存和索引文档以获得即时响应
• 运行后不需要web请求

______________________________________________________________________

演示（示例）

问：

• “解释一下Liquidsoap脚本的作用。”
• “在HLS输出之前添加回退。”
• “显示以下文档 crossfade.”
• “修复此脚本中弃用的函数。”
• “使用Liquidsoap 2.4.0-style重写此内容 null.”

你的AI会使用 *仅* 固定的2.4.0文档。

______________________________________________________________________

安装

先决条件

• Node.js≥18
• 任何兼容MCP的客户端

通过npm安装（推荐）

npm install -g liquidsoap-mcp-server

或从源运行

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

______________________________________________________________________

用法

Claude桌面示例

macOS：\ ~/Library/Application Support/Claude/claude_desktop_config.json

窗户：\ %APPDATA%/Claude/claude_desktop_config.json

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

来源：

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

Docker：

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

塑造形象：

docker build -t liquidsoap-mcp-server .

______________________________________________________________________

支持的工具

核心工具

• get_version
• list_sections
• get_documentation(section)
• search_functions(query)
• get_changelog
• get_examples(topic)
• validate_script_syntax(script)

文件部分

• language
• reference
• protocols
• settings
• encoding_formats
• ffmpeg
• quickstart
• cookbook

______________________________________________________________________

路线图

• \[\]Liquidsoap脚本图形可视化
• \[\]集成 liquidsoap --check 用于完整类型验证
• \[\]多版本切换（2.2.x、2.3.x等）
• \[\]模糊搜索和语义函数查找
• \[\]“解释此错误日志”工具
• \[\]模式/代码段库

______________________________________________________________________

贡献

PR欢迎。特别是：

• 更多示例
• 更好的搜索
• 文档解析改进
• 附加验证规则
• MCP集成模板

______________________________________________________________________

资源

• https://www.liquidsoap.info/doc-2.4.0/
• https://modelcontextprotocol.io/
• https://github.com/modelcontextprotocol/typescript-sdk

______________________________________________________________________

致谢

专为Liquidsoap社区以及DJ、网络广播运营商、自助主机和音频爱好者而设计，他们希望Liquidsoapp在人工智能的帮助下更容易、更安全、更有趣。

______________________________________________________________________

想支持这个项目吗？

请在回购中加星！\ 它帮助其他人发现它，告诉我这个利基市场值得开拓。