Liquidsoap文档服务器

提供Liquidsoap 2.4.0版本的准确文档和代码生成,支持AI助手进行脚本理解、代码生成和错误修复。

  • by splinesreticulating
  • JavaScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 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在人工智能的帮助下更容易、更安全、更有趣。


想支持这个项目吗?

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