liquidsoapmcp

🚀 LiquidSoap MCP Server

借助官方2.4.0文档，实现版本精准的Liquidsoap脚本编写。

大语言模型（LLMs）在处理Liquidsoap时常常出错，它们往往会混淆1.x版本的文档、过时的博客文章以及记忆模糊的API示例。而这个MCP服务器就能解决这些问题。它能为你的AI助手（如Claude、ChatGPT、Cursor、Windsurf等）提供真实的Liquidsoap 2.4.0文档、示例和API参考，从而让你能够：

• 理解 .liq 脚本
• 生成正确的2.4.0代码
• 修复错误和弃用用法
• 探索运算符、函数、过渡效果和模式
• 自信地构建网络广播管道

从此告别幻觉、版本偏差和神秘错误。

🚀 快速开始

LLMs在处理Liquidsoap时错误频出，常混淆不同版本文档和示例。而此MCP服务器能为其提供精准的Liquidsoap 2.4.0文档等资源，助力开发者更好地使用Liquidsoap。

✨ 主要特性

版本锁定文档（2.4.0）

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

智能搜索

• 按名称或关键字搜索函数/运算符
• 在示例、模式和实用指南项中搜索
• 搜索2.4.0更新日志和迁移说明

脚本辅助

• 检测弃用函数（如 null()、insert_metadata）
• 警告1.x版本语法问题
• 突出常见设计陷阱

示例库

提供即用型代码片段：

• 交叉淡入淡出
• 备用链
• 港口实时输入
• HLS输出
• 定时调度（cron.add、cron.parse）
• 元数据重写
• LUFS标准化
• 空白检测
• 多输出管道

快速本地服务

• 文档缓存并索引，可即时响应
• 运行后无需网络请求

📦 安装指南

前提条件

• 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

Windows系统：
%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等）
• [ ] 模糊搜索和语义函数查找
• [ ] “解释此错误日志”工具
• [ ] 模式/代码片段库

贡献

欢迎提交拉取请求，特别是在以下方面：

• 更多示例
• 更优搜索功能
• 文档解析改进
• 额外验证规则
• MCP集成模板

资源

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

致谢

本项目为Liquidsoap社区而建，也为那些希望借助AI辅助让Liquidsoap使用更轻松、更安全、更有趣的DJ、网络广播运营商、自托管者和音频爱好者而建。

支持项目

请给仓库点个星！ 这有助于他人发现该项目，也让我知道这个小众领域值得深耕。