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命令
• 文檔集成：內置交互式幫助和全面的文檔資源
• 健壯的路徑處理：自動轉換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 .

💻 使用示例

基礎用法

服務器提供了一系列實用工具，以下是部分工具的使用示例：

# 分析視頻文件並輸出詳細流信息
analyze_video('file:///Users/username/Videos/my_video.mp4')

# 執行自定義的Shaka Packager命令
run_shaka_packager('your_custom_command')

# 獲取可用命令選項和版本信息
get_shaka_options()

# 提供全面的文檔資源
get_shaka_documentation()

高級用法

服務器內置了多種提問模板，可用於不同的視頻處理場景，例如MP4轉TS格式、VOD包裝為HLS和DASH等。以下是使用提問模板進行視頻分析的示例：

# 視頻分析
# 向服務器發送提問模板請求
# 服務器會根據模板進行相應的視頻處理操作
# 這裡假設服務器有對應的處理邏輯
# 實際使用中可能需要根據服務器的API進行調用
# 示例代碼僅為示意
video_analysis_request = '視頻分析'
# 調用服務器接口發送請求
# response = server.send_request(video_analysis_request)

📚 詳細文檔

工具集

該服務器提供以下工具：

1. analyze_video：分析視頻文件並輸出詳細流信息
2. run_shaka_packager：執行自定義的Shaka Packager命令
3. get_shaka_options：獲取可用命令選項和版本信息
4. get_shaka_documentation：提供全面的文檔資源

提問模板

服務器內置以下提示模板：

• MP4轉TS格式
• VOD包裝為HLS和DASH
• 直播流包裝
• 內容加密
• 廣告插入準備
• 視頻分析
• 命令格式提醒
• 錯誤解釋指導

配置選項

服務器可通過環境變量進行配置：

🔧 技術細節

Shaka Packager MCP服務器的主要組件包括：

• shaka_packager_mcp.py：核心服務實現，包含MCP工具和提示
• tests/：測試套件，用於驗證功能

該服務器設計上與官方的MCP文件系統服務器配合使用。

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。

項目地址

• 倉庫地址：https://github.com/coderjun/shaka-packager-mcp
• 貢獻指南：請參考CONTRIBUTING.md

獲取幫助

如有任何問題或疑問：

1. 首先查看此README中的故障排除部分
2. 查閱Shaka Packager文檔
3. 使用內置的get_shaka_documentation工具獲取交互式幫助
4. 在GitHub上提交問題