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、網絡廣播運營商、自託管者和音頻愛好者而建。

支持項目

請給倉庫點個星！ 這有助於他人發現該項目，也讓我知道這個小眾領域值得深耕。