Qwen3-VL Video Understanding MCP Server

Qwen3-VL视频理解MCP服务器（Blaxel）

MCP（模型上下文协议）服务器，使Claude和其他AI代理能够使用部署在Blaxel上的Qwen3-VL-8B-Instruct分析视频和图像。

特性

• 视频分析：使用自定义提示通过URL分析视频
• 图像分析：通过URL分析图像
• 视频摘要：生成不同样式的摘要
• 文本提取：提取屏幕文本并转录语音
• 视频问答：询问有关视频内容的具体问题
• H100 GPU：通过Blaxel在NVIDIA H100 GPU上进行快速推理

建筑

Claude/Agent → MCP Server → Blaxel API → Qwen3-VL (H100 GPUs)

先决条件

1. Blaxel帐户：注册地址： 布莱克塞尔艾
2. Blaxel命令行界面：安装Blaxel CLI
3. FFmpeg：视频帧提取所需
4. Python 3.10+

快速开始

1.将模型部署到Blaxel

cat << 'EOF' | blaxel apply -f -
apiVersion: blaxel.ai/v1alpha1
kind: Model
metadata:
  name: qwen-qwen3-vl-8b-instruct
  displayName: Qwen/Qwen3-VL-8B-Instruct
spec:
  enabled: true
  policies: []
  flavors:
    - name: nvidia-h100/x4
      type: gpu
  runtime:
    model: Qwen/Qwen3-VL-8B-Instruct
    type: hf_private_endpoint
    image: ''
    args: []
    endpointName: qwenqwen3-vl-8b-instruct-nvidia-h100
    organization: adamanz
  integrationConnections:
    - huggingface-4s2m2h
EOF

或者使用提供的配置：

blaxel apply -f blaxel-model.yaml

2.获取API密钥

blaxel auth token

3.安装MCP服务器

cd qwen-video-blaxel-mcp
pip install -e .

或者使用紫外线：

uv pip install -e .

4.配置环境

cp .env.example .env
# Edit .env with your Blaxel API key

5.添加到克劳德桌面

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "qwen3-video-blaxel": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/qwen-video-blaxel-mcp",
        "run",
        "server.py"
      ],
      "env": {
        "BLAXEL_API_KEY": "your-blaxel-api-key",
        "BLAXEL_MODEL": "qwen-qwen3-vl-8b-instruct"
      }
    }
  }
}

6.重新启动克劳德桌面

这 qwen3-video-blaxel 工具现在应该可用了。

可用工具

analyze_video

使用自定义提示分析视频。

analyze_video(
  video_url="https://example.com/video.mp4",
  question="What happens in this video?",
  max_frames=8
)

analyze_image

使用自定义提示分析图像。

analyze_image(
  image_url="https://example.com/image.jpg",
  question="Describe this image"
)

summarize_video

生成视频摘要。

summarize_video(
  video_url="https://example.com/video.mp4",
  style="detailed"  # brief, standard, or detailed
)

video_qa

询问有关视频的具体问题。

video_qa(
  video_url="https://example.com/video.mp4",
  question="How many people appear?"
)

extract_video_text

提取文本并转录语音。

extract_video_text(
  video_url="https://example.com/presentation.mp4"
)

check_configuration

检查Blaxel API配置。

list_capabilities

列出所有服务器功能。

配置

需求

• FFmpeg：视频帧提取所需

  # macOS
  brew install ffmpeg

  # Ubuntu/Debian
  apt install ffmpeg

支持格式

视频：mp4、webm、mov、avi

图像：JPG、JPEG、PNG、GIF、webp

比较：Modal与Blaxel

许可证

麻省理工学院