Shaka Packager MCP Server

🚀 Claude用Shaka Packager MCPサーバー

このサーバーはClaude向けに設計されたMCPサーバーで、Shaka Packagerを制御してビデオ分析とパッケージングタスクを実行します。

🚀 クイックスタート

環境変数の設定

環境変数は以下の場所で設定できます：

1. Claudeデスクトップ設定ファイル（SHAKA_PACKAGER_PATHとVIDEO_PATHに推奨）
2. システム環境変数
3. プロジェクトディレクトリ内の.envファイル

.envファイルの例：

SHAKA_PACKER_PATH=/usr/local/bin/packager
VIDEO_PATH=/Users/yourusername/Videos
LOG_LEVEL=DEBUG

使用例

1. ビデオファイルの表示：

   Please show me the files in my Videos directory
   

2. 特定のサブディレクトリへの移動：

   Please show me the files in the Movies subdirectory
   

3. 対象ビデオのfile:// URIパスの取得

4. Shaka Packagerツールを使用したビデオ処理：

   Please analyze this video: file:///Users/username/Videos/my_video.mp4
   

✨ 主な機能

• 自動パス変換：Dockerコンテナとホスト環境間のファイルパス変換をスマートに処理します。
• エラー処理と提案：意味のあるエラーメッセージと修正提案を提供します。
• コマンド形式の支援：Shaka Packagerコマンドの正しい形式を支援します。
• ドキュメント統合：組み込みのインタラクティブなヘルプと包括的なドキュメントリソースを提供します。

📦 インストール

pipを使用したインストール

# リポジトリをクローン
git clone https://github.com/coderjun/shaka-packager-mcp.git
cd shaka-packager-mcp

# pipを使用してインストール
pip install -e .

# またはuvを使用してインストール
uv pip install -e .

💻 使用例

基本的な使用法

# ビデオファイルの表示
Please show me the files in my Videos directory

高度な使用法

# Shaka Packagerツールを使用したビデオ処理
Please analyze this video: file:///Users/username/Videos/my_video.mp4

📚 ドキュメント

ツールセット

このサーバーは以下のツールを提供します：

1. analyze_video：ビデオファイルを分析し、詳細なストリーム情報を出力します。
2. run_shaka_packager：カスタムのShaka Packagerコマンドを実行します。
3. get_shaka_options：利用可能なコマンドオプションとバージョン情報を取得します。
4. get_shaka_documentation：包括的なドキュメントリソースを提供します。

質問テンプレート

サーバーには以下のプロンプトテンプレートが組み込まれています：

• MP4をTS形式に変換
• VODをHLSとDASHにパッケージ化
• ライブストリームのパッケージ化
• コンテンツの暗号化
• 広告挿入の準備
• ビデオ分析
• コマンド形式のリマインダー
• エラーの説明ガイド

設定オプション

サーバーは環境変数で設定できます：

• SHAKA_PACKER_PATH：Shaka Packager実行可能ファイルのパスを指定します（Claudeデスクトップ設定で推奨）
• VIDEO_PATH：ローカルビデオディレクトリを指定します（パス変換用）
• DOCKER_PATH：Dockerコンテナのマウントパス（デフォルトは"/projects/video-drop"）
• TEMP_DIR：カスタム一時フォルダ
• LOG_LEVEL：ログレベル（DEBUG、INFO、WARNING、ERROR、CRITICAL）
• COMMAND_TIMEOUT：コマンドのタイムアウト時間（秒、デフォルトは300）

開発ガイド

環境構築

# リポジトリをクローン
git clone https://github.com/coderjun/shaka-packager-mcp.git
cd shaka-packager-mcp

# 開発依存関係をインストール
pip install -e ".[dev]"

# またはuvを使用してインストール
uv pip install -e ".[dev]"

テストの実行

pytest

コードのフォーマット

black .
isort .

コード構造の理解

Shaka Packager MCPサーバーの主なコンポーネントは以下の通りです：

• shaka_packager_mcp.py：コアサービスの実装で、MCPツールとプロンプトを含みます。
• tests/：機能を検証するためのテストスイートです。

このサーバーは公式のMCPファイルシステムサーバーと連携するように設計されています。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルを参照してください。

ヘルプの取得

何か問題や質問がある場合は：

1. まずこのREADMEのトラブルシューティングセクションを確認してください。
2. Shaka Packagerドキュメントを参照してください。
3. 組み込みのget_shaka_documentationツールを使用してインタラクティブなヘルプを取得してください。
4. GitHubで問題を提出してください。

プロジェクトのアドレス

• リポジトリアドレス：https://github.com/coderjun/shaka-packager-mcp
• コントリビューションガイド：CONTRIBUTING.mdを参照してください。