Provides comprehensive video file analysis capabilities using FFmpeg, including extraction of video metadata, stream analysis, bitrate calculations, and technical parameter reporting across multiple formats
🎬 Video Info MCP
🚀 基于 MCP (Model Context Protocol) 协议的专业视频信息分析工具,为 AI 助手提供强大的视频文件分析能力
✨ 特性
- 🎯 专业分析: 基于 FFmpeg 的深度视频信息提取
- 📊 多维度数据: 视频流、音频流、码率、质量评估
- 📝 多格式报告: 支持 JSON、TEXT、Markdown 格式输出
- 🔧 MCP 兼容: 完全符合 Model Context Protocol 规范
- ⚡ 高性能: 平均响应时间 < 500ms
- 🌐 跨平台: 支持 Windows、macOS、Linux
- 🛡️ 类型安全: 使用 TypeScript 和 Zod 进行严格类型检查
📦 安装
作为 MCP 服务器使用(推荐)
在您的 AI 助手配置文件中添加:
全局安装
🚀 快速开始
Claude Desktop 配置
- 打开 Claude Desktop 配置文件:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Linux:
~/.config/claude/claude_desktop_config.json
- Windows:
- 添加 MCP 服务器配置:
- 重启 Claude Desktop
其他 AI 助手配置
对于支持 MCP 协议的其他 AI 助手,请参考相应的配置文档,使用以下命令:
🛠️ 功能说明
可用工具
工具名称 | 描述 | 响应时间 |
---|---|---|
get_video_info | 📹 获取视频文件的详细信息 | ~400ms |
analyze_streams | 🔍 分析视频流和音频流参数 | ~300ms |
calculate_bitrate | 📊 计算码率和文件大小分析 | ~300ms |
generate_report | 📝 生成多格式技术报告 | ~280ms |
支持的视频格式
- 容器格式: MP4, MOV, AVI, MKV, WebM, FLV, 3GP, M4V
- 视频编码: H.264, H.265/HEVC, VP8, VP9, AV1, MPEG-4
- 音频编码: AAC, MP3, AC-3, DTS, FLAC, Opus, Vorbis
📖 使用示例
基本用法
在支持 MCP 的 AI 助手中,您可以直接使用自然语言请求:
API 调用示例
📊 输出示例
视频信息输出
🔧 疑难解答
常见问题
❌ 连接错误 "Connection closed"
这通常是由于 npx
缓存问题导致的。请按以下顺序尝试解决:
1. 使用 @latest 标签(首选方案)
2. 锁定到特定版本(备用方案)
3. 清理 npx 缓存(终极方案)
❌ FFmpeg 未找到
确保系统已安装 FFmpeg:
Windows:
macOS:
Linux:
❌ 权限错误
确保 AI 助手有权限访问视频文件路径,建议使用绝对路径。
❌ 文件格式不支持
检查视频文件是否损坏,或尝试使用其他工具转换为常见格式(如 MP4)。
性能优化建议
- 🚀 对于大文件(>1GB),分析可能需要更长时间
- 💾 建议将常用视频文件放在 SSD 上以提高分析速度
- 🔄 避免同时分析多个大文件
🤝 贡献
欢迎贡献代码!请遵循以下步骤:
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature
) - 提交更改 (
git commit -m 'Add some AmazingFeature'
) - 推送到分支 (
git push origin feature/AmazingFeature
) - 开启 Pull Request
📄 许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
🔗 相关链接
📞 联系方式
如有问题或建议,欢迎联系:
微信: pickstar_loveXX
⭐ 如果这个项目对您有帮助,请给个 Star!
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables comprehensive video file analysis including extracting metadata, stream information, bitrate calculations, and generating technical reports. Supports all FFmpeg-compatible video formats with output in JSON, text, or Markdown formats.
Related MCP Servers
- -securityFlicense-qualityEnables video editing using natural language commands powered by FFmpeg, supporting operations like trimming, merging, format conversion, and more with real-time progress tracking and error handling.Last updated -34Python
- AsecurityFlicenseAqualityEnables interaction with YouTube videos by extracting metadata, captions in multiple languages, and converting content to markdown with various templates.Last updated -191TypeScript
- AsecurityAlicenseAqualityProvides powerful video and audio editing capabilities through FFmpeg, enabling AI assistants to perform professional-grade operations including format conversion, trimming, overlays, transitions, and advanced audio processing.Last updated -2719PythonMIT License
- AsecurityAlicenseAqualityProvides tools for analyzing project structures, searching through codebases, managing dependencies, and performing file operations with advanced filtering capabilities.Last updated -65121TypeScriptMIT License