Labsco
adamanz logo

MCP Video Converter Server

from adamanz

Convert video files between various formats using FFmpeg. Requires FFmpeg to be installed on the system.

🔥🔥🔥✓ VerifiedFreeNeeds API keys
#devops#git#search#monitoring#video-editing

MCP Video Converter Server

An MCP server that provides tools for checking FFmpeg installation and converting video files between various formats.

Features

  • Check FFmpeg: Verifies if FFmpeg is installed and accessible.
  • Convert Video: Converts video, audio, and image files to various formats (e.g., MP4, WebM, MOV, MP3, PNG).
  • Format Info: Get a list of supported file formats for conversion.

Integrating with Claude Desktop

To add this MCP server to Claude Desktop:

  1. Locate or create the Claude Desktop configuration file:

    # macOS
mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
mkdir -p %APPDATA%\Claude\
notepad %APPDATA%\Claude\claude_desktop_config.json

  2. Add the MCP server configuration:

    {
  "mcpServers": {
    "video-convert": {
      "command": "/bin/bash",
      "args": [
        "-c",
        "cd /absolute/path/to/mcp-video-converter && source .venv/bin/activate && python -m mcp_video_converter.server"
      ]
    }
  }
}

    Windows Alternative:

    {
  "mcpServers": {
    "video-convert": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "cd /d C:\\absolute\\path\\to\\mcp-video-converter && .venv\\Scripts\\activate && python -m mcp_video_converter.server"
      ]
    }
  }
}

    Replace /absolute/path/to/mcp-video-converter with the absolute path to your repository.

  3. Restart Claude Desktop

    • The server will appear as "video-convert" in the MCP tools menu

  4. Important notes:

    • Always use absolute paths in your configuration
    • Make sure FFmpeg is installed and in your PATH
    • If you encounter issues, check the Claude Desktop logs: 
      # macOS
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log

# Windows
type %APPDATA%\Claude\logs\mcp*.log

Integrating with Cursor

To add this MCP server to Cursor:

  1. Locate or create the Cursor configuration file:

    # macOS
mkdir -p ~/.cursor/
nano ~/.cursor/config.json

# Windows
mkdir -p %USERPROFILE%\.cursor\
notepad %USERPROFILE%\.cursor\config.json

  2. Add the MCP server configuration:

    {
  "ai": {
    "mcpServers": {
      "video-convert": {
        "command": "/bin/bash",
        "args": [
          "-c",
          "cd /absolute/path/to/mcp-video-converter && source .venv/bin/activate && python -m mcp_video_converter.server"
        ]
      }
    }
  }
}

    Windows Alternative:

    {
  "ai": {
    "mcpServers": {
      "video-convert": {
        "command": "cmd.exe",
        "args": [
          "/c",
          "cd /d C:\\absolute\\path\\to\\mcp-video-converter && .venv\\Scripts\\activate && python -m mcp_video_converter.server"
        ]
      }
    }
  }
}

    Replace /absolute/path/to/mcp-video-converter with the absolute path to your repository.

  3. Restart Cursor

    • The server will be available to Claude in Cursor

  4. Important notes:

    • Always use absolute paths in your configuration
    • Make sure FFmpeg is installed and in your PATH
    • Logs may be accessed through Cursor's developer tools

Advanced: Using with fastmcp client

For programmatic usage, you can use the fastmcp client:

# Check FFmpeg installation
fastmcp client call <SERVER_URL_OR_FILE_PATH> check_ffmpeg_installed '{}'

# Get supported formats
fastmcp client call <SERVER_URL_OR_FILE_PATH> get_supported_formats '{}'

# Convert a video
fastmcp client call <SERVER_URL_OR_FILE_PATH> convert_video '{
  "input_file_path": "/path/to/your/video.webm", 
  "output_format": "mp4", 
  "quality": "high"
}'

Replace /path/to/your/video.webm with an actual video file path.

Supported Formats

  • Video: MP4, WebM, MOV, AVI, MKV, FLV, GIF
  • Audio: MP3, WAV, OGG, AAC, M4A
  • Image: WebP, JPG, PNG, BMP, TIFF