aigroup-video-mcp

# Aigroup Video MCP Aigroup Video MCP 是一个基于阿里云 DashScope 的视频多模态理解 MCP（Model Context Protocol）服务器，提供强大的视频内容分析功能。 [](https://python.org) [](LICENSE) [](https://modelcontextprotocol.io) ## 🌟 特性 - **🎥 视频内容分析**：支持通过 URL 或本地路径分析视频内容 - **🧠 智能摘要**：自动生成视频摘要和关键信息 - **🎬 场景识别**：识别视频中的主要场景和场景转换 - **✨ 自定义提示词**：支持灵活的自定义分析需求 - **🔌 MCP 协议支持**：完全兼容 MCP 协议，支持 stdio 和 SSE 模式 - **⚡ 高性能处理**：基于异步处理，支持并发请求 - **📊 使用统计**：内置使用统计和监控功能 - **🛡️ 安全配置**：支持域名白名单、文件大小限制等安全特性 ## 🎯 核心功能 ### 视频分析工具 - **analyze_video**: 基础视频内容分析 - **summarize_video**: 视频摘要生成（支持简要、详细、通用三种模式） - **analyze_video_scenes**: 视频场景分析和转换检测 - **analyze_video_custom**: 自定义提示词视频分析 - **validate_video_source**: 视频源验证和检查 ### 系统资源 - **config://system**: 系统配置信息 - **models://available**: 可用模型信息 - **status://system**: 系统状态和健康检查 - **stats://usage**: 使用统计和分析报告 ## 🚀 快速开始 ### 环境要求 - Python 3.8+ - DashScope API Key ### 安装 ```bash # 克隆项目 git clone https://github.com/jackdark425/aigroup-video-mcp.git cd aigroup-video-mcp # 安装依赖 pip install -r requirements.txt # 或使用 pip 安装 pip install aigroup-video-mcp ``` ### 配置 1. 复制环境变量示例文件： ```bash cp .env.example .env ``` 2. 编辑 `.env` 文件，设置你的 DashScope API Key： ```bash DASHSCOPE_API_KEY=your_dashscope_api_key_here ``` 3. 或者直接设置环境变量： ```bash export DASHSCOPE_API_KEY=your_dashscope_api_key_here ``` ### 运行服务器 #### MCP 模式（默认） ```bash # 使用 stdio 传输模式（推荐用于 MCP 客户端） python -m aigroup_video_mcp.main serve ``` #### SSE 模式 ```bash # 使用 SSE 传输模式（用于 HTTP 客户端） python -m aigroup_video_mcp.main serve --transport sse --host 0.0.0.0 --port 3001 ``` ## 📖 使用示例 ### 命令行工具 #### 分析视频文件 ```bash # 基础视频分析 python -m aigroup_video_mcp.main analyze video.mp4 # 使用自定义提示词 python -m aigroup_video_mcp.main analyze vid…