Video Info MCP

🚀 🎬 Video Info MCP

基於 MCP (Model Context Protocol) 協議的專業視頻信息分析工具，為 AI 助手提供強大的視頻文件分析能力，可進行深度視頻信息提取、多維度數據解析，並生成多格式報告。

🚀 快速開始

Claude Desktop 配置

1. 打開 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
2. 添加 MCP 服務器配置：

{
  "mcpServers": {
    "video-info": {
      "command": "npx",
      "args": ["@pickstar-2002/video-info-mcp@latest"],
      "env": {}
    }
  }
}

3. 重啟 Claude Desktop

其他 AI 助手配置

對於支持 MCP 協議的其他 AI 助手，請參考相應的配置文檔，使用以下命令：

npx @pickstar-2002/video-info-mcp@latest

✨ 主要特性

• 🎯 專業分析：基於 FFmpeg 的深度視頻信息提取。
• 📊 多維度數據：視頻流、音頻流、碼率、質量評估。
• 📝 多格式報告：支持 JSON、TEXT、Markdown 格式輸出。
• 🔧 MCP 兼容：完全符合 Model Context Protocol 規範。
• ⚡ 高性能：平均響應時間 < 500ms。
• 🌐 跨平臺：支持 Windows、macOS、Linux。
• 🛡️ 類型安全：使用 TypeScript 和 Zod 進行嚴格類型檢查。

📦 安裝指南

作為 MCP 服務器使用（推薦）

在您的 AI 助手配置文件中添加：

{
  "mcpServers": {
    "video-info": {
      "command": "npx",
      "args": ["@pickstar-2002/video-info-mcp@latest"],
      "env": {}
    }
  }
}

全局安裝

npm install -g @pickstar-2002/video-info-mcp@latest

🛠️ 功能說明

可用工具

支持的視頻格式

• 容器格式：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 助手中，您可以直接使用自然語言請求：

"請分析這個視頻文件的信息：/path/to/video.mp4"
"生成這個視頻的技術報告，使用 Markdown 格式"
"計算這個視頻文件的碼率信息"

高級用法

// get_video_info - 獲取基本信息
{
  "name": "get_video_info",
  "arguments": {
    "filePath": "/path/to/video.mp4"
  }
}

// analyze_streams - 流分析
{
  "name": "analyze_streams", 
  "arguments": {
    "filePath": "/path/to/video.mp4",
    "includeMetadata": true
  }
}

// generate_report - 生成報告
{
  "name": "generate_report",
  "arguments": {
    "filePath": "/path/to/video.mp4",
    "format": "markdown"
  }
}

📊 輸出示例

視頻信息輸出

{
  "filename": "sample.mp4",
  "fileSize": "20.43 MB",
  "duration": "289.4",
  "format": "mov,mp4,m4a,3gp,3g2,mj2",
  "videoStreams": [{
    "codec": "h264",
    "resolution": "1920x1080",
    "frameRate": "30/1",
    "bitRate": "423986"
  }],
  "audioStreams": [{
    "codec": "aac",
    "sampleRate": "48000",
    "channels": 2,
    "bitRate": "164221"
  }],
  "technicalReport": {
    "videoQuality": "1080p高清",
    "audioQuality": "標準品質",
    "recommendations": [
      "建議提高視頻碼率以獲得更好的1080p質量",
      "使用H.264編碼，兼容性良好"
    ]
  }
}

🔧 技術細節

常見問題

❌ 連接錯誤 "Connection closed"

這通常是由於 npx 緩存問題導致的。請按以下順序嘗試解決： 1. 使用 @latest 標籤（首選方案）

{
  "mcpServers": {
    "video-info": {
      "command": "npx",
      "args": ["@pickstar-2002/video-info-mcp@latest"],
      "env": {}
    }
  }
}

2. 鎖定到特定版本（備用方案）

{
  "mcpServers": {
    "video-info": {
      "command": "npx",
      "args": ["@pickstar-2002/video-info-mcp@1.1.0"],
      "env": {}
    }
  }
}

3. 清理 npx 緩存（終極方案）

# 清理 npx 緩存
npx clear-npx-cache

# 或者手動刪除緩存目錄
# Windows: %LOCALAPPDATA%\npm-cache\_npx
# macOS/Linux: ~/.npm/_npx

❌ FFmpeg 未找到

確保系統已安裝 FFmpeg： Windows:

# 使用 Chocolatey
choco install ffmpeg

# 使用 Scoop  
scoop install ffmpeg

macOS:

# 使用 Homebrew
brew install ffmpeg

Linux:

# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg

# CentOS/RHEL
sudo yum install ffmpeg

❌ 權限錯誤

確保 AI 助手有權限訪問視頻文件路徑，建議使用絕對路徑。

❌ 文件格式不支持

檢查視頻文件是否損壞，或嘗試使用其他工具轉換為常見格式（如 MP4）。

性能優化建議

• 🚀 對於大文件（>1GB），分析可能需要更長時間。
• 💾 建議將常用視頻文件放在 SSD 上以提高分析速度。
• 🔄 避免同時分析多個大文件。

🤝 貢獻

歡迎貢獻代碼！請遵循以下步驟：

1. Fork 本倉庫。
2. 創建特性分支 (git checkout -b feature/AmazingFeature)。
3. 提交更改 (git commit -m 'Add some AmazingFeature')。
4. 推送到分支 (git push origin feature/AmazingFeature)。
5. 開啟 Pull Request。

📄 許可證

本項目採用 MIT 許可證 - 查看 LICENSE 文件瞭解詳情。

🔗 相關鏈接

• Model Context Protocol
• Claude Desktop
• FFmpeg 官網

📞 聯繫方式

如有問題或建議，歡迎聯繫： 微信：pickstar_loveXX

⭐ 如果這個項目對您有幫助，請給個 Star！