视频理解与检索服务

基于AWS的标准MCP协议视频理解与检索服务器,提供视频嵌入生成、自然语言场景搜索、视频摘要等核心功能,适用于高效低成本的视频内容分析场景。

  • by Taehooon6476
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Taehooon6476/video-understanding-mcp

使用说明

视频理解MCP服务器(标准)

遵循标准MCP协议的基于AWS的视频理解和搜索服务器。

主要区别(vs Hybrid版本)

特点 Standard(此版本) Hybrid
结构 标准MCP MCP+Strands Agents
工具数量 7个(明确的参数)4个(抽象的)
AI调用 1号(仅客户端)2号(客户端+服务器)
费用 价格便宜2倍
响应速度 快,慢
Smithery注册 建议 可以,但不标准

主要功能

7个标准MCP工具

  1. 创建_视频_嵌入 -创建视频嵌入
  2. search_video_clips -搜索自然语言场景
  3. get_clip_playback_url -生成播放URL
  4. 摘要_视频 -视频摘要
  5. get_transcript -字幕生成/查询
  6. 获取关键字 -提取关键字
  7. 转码IP -提取和保存剪辑

安装

cd video-understanding-mcp-standard
pip install -e .

设置Kiro CLI

~/.kiro/settings/mcp.json:

{
  "video-processing-standard": {
    "command": "video-mcp-standard",
    "env": {
      "AWS_REGION": "us-east-1",
      "S3_VECTORS_BUCKET": "my-video-vectors",
      "S3_VECTORS_INDEX": "video-index",
      "DYNAMODB_TABLE": "video-tasks",
      "S3_UPLOAD_BUCKET": "my-video-uploads"
    }
  }
}

创建AWS资源

# S3 Vectors
aws s3vectors create-vector-bucket --bucket-name my-video-vectors
aws s3vectors create-index \
  --bucket-name my-video-vectors \
  --index-name video-index \
  --vector-dimension 1024 \
  --distance-metric cosine

# DynamoDB
aws dynamodb create-table \
  --table-name video-tasks \
  --attribute-definitions AttributeName=task_id,AttributeType=S \
  --key-schema AttributeName=task_id,KeyType=HASH \
  --billing-mode PAY_PER_REQUEST

# S3 버킷
aws s3 mb s3://my-video-uploads

使用示例

在Kiro CLI中

사용자: "~/Videos/soccer.mp4 임베딩 생성해줘"
AI: create_video_embedding 도구 호출...
    완료: 150개 클립 저장

사용자: "골 장면 찾아줘"
AI: search_video_clips 도구 호출...
    3개 발견:
    - 2:34-2:40 (유사도: 0.89)
    - 15:22-15:28 (유사도: 0.85)

사용자: "첫 번째 클립 추출해줘"
AI: transcode_clip 도구 호출...
    soccer_clip_154_160.mp4 저장 완료

技术堆栈

  • 主控程序:标准Model Context协议
  • AWS基岩:Marengo(嵌入式)、Pegasus(摘要)、Claude(关键字)
  • S3矢量:矢量搜索
  • DynamoDB:跟踪任务
  • 转录:生成字幕
  • FFmpeg:视频转码

体系结构

Kiro CLI (AI 클라이언트)
    ↓ MCP Protocol
Standard MCP Server
    ↓ 직접 호출
AWS Services (Bedrock, S3 Vectors, etc.)

核心:AI代理不在服务器内部→更快更便宜

许可证

麻省理工学院