Video Tools MCP Server

FastMCP сервер для работы с видео. Предоставляет инструменты для извлечения кадров, метаданных, аудио и создания GIF.

Требования

• Python 3.10+
• FFmpeg (должен быть установлен и доступен в PATH)

Установка FFmpeg

Ubuntu/Debian:

sudo apt update && sudo apt install ffmpeg

macOS:

brew install ffmpeg

Windows: Скачать с ffmpeg.org и добавить в PATH.

Установка

Из PyPI (рекомендуется)

pip install video-tools-mcp

Из исходников

git clone https://github.com/TiGRoNdev/video-tools-mcp.git
cd video-tools-mcp
pip install -e .

Запуск

video-tools-mcp

Или напрямую:

python video_mcp_server.py

Инструменты

get_video_metadata

Получить полные метаданные видео: длительность, разрешение, FPS, кодек, битрейт, информацию об аудио.

get_video_metadata(video_path="/path/to/video.mp4")

get_video_duration

Получить длительность видео в различных форматах.

get_video_duration(video_path="/path/to/video.mp4")

extract_frame

Извлечь один кадр по указанному времени.

extract_frame(
    video_path="/path/to/video.mp4",
    timestamp="00:01:30",  # или "90" для 90 секунд
    output_path="/path/to/frame.png",  # опционально
    width=1280,  # опционально
    height=720,  # опционально
    return_base64=True  # вернуть base64 данные
)

extract_frames_interval

Извлечь кадры с заданным интервалом.

extract_frames_interval(
    video_path="/path/to/video.mp4",
    interval_seconds=1.0,  # кадр каждую секунду
    output_dir="/path/to/frames/",
    start_time="00:00:10",
    end_time="00:01:00",
    max_frames=50
)

extract_audio

Извлечь аудиодорожку из видео.

extract_audio(
    video_path="/path/to/video.mp4",
    output_path="/path/to/audio.mp3",
    format="mp3",  # mp3, wav, aac, flac, ogg
    bitrate="192k",
    start_time="00:00:00",
    end_time="00:05:00"
)

create_gif

Создать GIF из видео.

create_gif(
    video_path="/path/to/video.mp4",
    output_path="/path/to/output.gif",
    start_time="00:00:05",
    duration=5.0,  # 5 секунд
    fps=10,
    width=480,
    optimize=True  # оптимизация палитры
)

Конфигурация для Claude Desktop

Добавьте в claude_desktop_config.json:

После установки из PyPI

{
  "mcpServers": {
    "video-tools": {
      "command": "video-tools-mcp"
    }
  }
}

Из исходников

{
  "mcpServers": {
    "video-tools": {
      "command": "python",
      "args": ["/path/to/video_mcp_server.py"]
    }
  }
}

Пример использования

После подключения к Claude Desktop или другому MCP клиенту:

Пользователь: Покажи информацию о видео /home/user/video.mp4

Claude: Вызываю get_video_metadata...
{
  "duration_seconds": 125.5,
  "video": {
    "width": 1920,
    "height": 1080,
    "fps": 30,
    "codec": "h264"
  },
  "audio": {
    "codec": "aac",
    "sample_rate": 48000
  }
}

Лицензия

MIT