关键词

媒体处理视频编辑图像处理FFmpegImageMagick

使用说明

项目简介

这是一个基于Node.js开发的MCP（Model Context Protocol）服务器，专注于提供强大的媒体处理能力。通过集成FFmpeg和ImageMagick等工具，该服务器能够处理各种视频和图像操作，为LLM应用提供可靠的媒体内容处理后端服务。

主要功能点

  • 视频处理: 支持视频格式转换、视频压缩、视频裁剪和编辑等功能，可以处理多种视频格式。
  • 图像处理: 支持图像格式转换、图像压缩、图像大小调整、图像旋转、添加水印以及应用各种视觉特效等功能，支持常见的图像格式。
  • 工具丰富: 提供了丰富的工具集，涵盖了媒体处理的常用操作，例如：
    • 'convert-video': 视频格式转换
    • 'compress-video': 视频压缩
    • 'trim-video': 视频裁剪
    • 'convert-image': 图像格式转换
    • 'resize-image': 图像尺寸调整
    • 'rotate-image': 图像旋转
    • 'add-watermark': 添加水印
    • 'apply-effect': 应用图像特效
    • 'execute-ffmpeg': 执行自定义FFmpeg命令 (高级功能)
    • 'compress-image': 图像压缩 (PNG 专用)

安装步骤

  1. 安装FFmpeg: 视频处理依赖FFmpeg，请根据您的操作系统安装FFmpeg。

    • macOS: 运行 'brew install ffmpeg'
    • Ubuntu/Debian: 运行 'sudo apt-get install ffmpeg'
    • Windows: 访问 FFmpeg官方网站 下载并安装。

  2. 安装ImageMagick: 图像处理依赖ImageMagick，请根据您的操作系统安装ImageMagick。

    • macOS: 运行 'brew install imagemagick'
    • Ubuntu/Debian: 运行 'sudo apt-get install imagemagick'
    • Windows: 访问 ImageMagick官方网站 下载并安装。

  3. 安装MCP Media Processing Server: 无需手动安装，通过NPX即可运行，或者您可以选择克隆仓库自行构建。

服务器配置

为了让MCP客户端（如 Claude 桌面应用）连接到此MCP服务器，您需要在客户端的配置文件（例如 'claude_desktop_config.json'）中添加服务器配置信息。以下是使用NPX运行此服务器的配置示例：

{
  "mcpServers": {
    "mediaProcessor": { // 服务器名称，可以自定义
      "command": "npx",  // 启动服务器的命令，这里使用 npx
      "args": [         // 启动参数
        "-y",         // npx 参数，自动确认安装包
        "mcp-media-processor@latest" //  使用 npmjs.com 发布的最新版本的 mcp-media-processor
      ]
    }
  }
}

配置说明:

  • '"mediaProcessor"': 是您为该MCP服务器定义的名称，可以自定义，在客户端中通过此名称引用该服务器。
  • '"command": "npx"': 指定使用 'npx' 命令来运行服务器。'npx' 允许您在不全局安装包的情况下运行 npm 包。
  • '"args": [...]"': 'npx' 命令的参数列表。
    • '"-y"': 'npx' 的参数，用于跳过安装包时的确认提示，自动确认安装。
    • '"mcp-media-processor@latest"': 指定要运行的 npm 包为 'mcp-media-processor'，并使用 '@latest' 获取最新发布的版本。

注意: 此配置假设您的环境中已安装 Node.js 和 npm (通常 Node.js 安装包会自带 npm)。MCP客户端会根据您提供的配置启动此服务器。

基本使用方法

  1. 确保已安装 FFmpeg 和 ImageMagick，并已将它们添加到系统环境变量中（如果需要）。
  2. 将上述服务器配置添加到您的 MCP 客户端配置文件中。
  3. 启动 MCP 客户端。客户端会根据配置自动启动 'mcp-media-processor' 服务器。
  4. 在 MCP 客户端中，您应该能够调用 'mediaProcessor' 服务器提供的各种媒体处理工具。具体的调用方式取决于 MCP 客户端的界面和功能，通常您可以在客户端的工具或插件市场中找到并使用这些工具。
  5. 工具执行时，需要提供输入文件的绝对路径以及其他工具所需的参数（例如输出格式、压缩质量等）。处理后的文件默认会保存在您用户目录下的 "Downloads" 文件夹中，除非您在工具参数中指定了自定义的输出路径。

信息

分类

AI与计算

访问项目