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上提交问题