Liquidsoapmcp

🚀 LiquidSoap MCP Server

公式の2.4.0ドキュメントを使用した、バージョン正確なLiquidsoapスクリプト。

LLMはLiquidsoapに関する情報を誤ったり、1.xのドキュメント、古いブログ記事、半分しか覚えていないAPIの例を混同したりすることが多いです。

このMCPサーバーはその問題を解決します。

このサーバーは、あなたのAIアシスタント（Claude、ChatGPT、Cursor、Windsurfなど）に実際のLiquidsoap 2.4.0のドキュメント、サンプル、APIリファレンスを提供し、以下のことを可能にします。

• .liqスクリプトを理解する
• 正しい2.4.0のコードを生成する
• エラーや非推奨の使用方法を修正する
• 演算子、関数、トランジション、パターンを探索する
• 自信を持ってウェブラジオパイプラインを構築する

幻覚やバージョンのずれ、謎のエラーはありません。

🚀 クイックスタート

このMCPサーバーを使用することで、AIアシスタントに正確なLiquidsoap 2.4.0のドキュメントやコード生成機能を提供できます。以下のセクションでは、サーバーの機能、インストール方法、使用方法などを説明します。

✨ 主な機能

バージョン固定のドキュメント (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 Desktopの例

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など)
• [ ] ファジー検索と意味的な関数検索
• [ ] “このエラーログを説明する”ツール
• [ ] パターン/スニペットライブラリ

コントリビュート

PRは大歓迎です。特に以下の点に関する貢献が期待されます。

• より多くのサンプル
• より良い検索機能
• ドキュメント解析の改善
• 追加の検証ルール
• MCP統合テンプレート

📄 ライセンス

ドキュメント内にライセンス情報は記載されていません。

リソース

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

謝辞

このプロジェクトは、Liquidsoapコミュニティや、AIアシスタントを使ってLiquidsoapをより簡単、安全、楽しく使いたいDJ、ウェブラジオオペレーター、セルフホスター、オーディオ愛好家のために開発されています。

プロジェクトをサポートしたいですか？

リポジトリにスターをつけてください！
これにより、他の人にこのプロジェクトを発見してもらえ、このニッチな分野が価値があったことを私に伝えることができます。