MCP Media Processing Server

MCP 媒体处理服务

一个基于 Node.js 实现 Model Context Protocol（MCP）的服务，用于媒体处理操作，提供强大的视频和图像处理能力。

功能

• 视频处理与转换
• 图像处理与编辑
• 媒体压缩
• 视频剪辑与编辑
• 图像特效与水印

前置条件

使用此服务前，请确保系统已安装以下依赖项：

• FFmpeg：视频处理操作所需

  • macOS：brew install ffmpeg
  • Ubuntu/Debian：sudo apt-get install ffmpeg
  • Windows：从 FFmpeg 官方网站下载

• ImageMagick：图像处理操作所需

  • macOS：brew install imagemagick
  • Ubuntu/Debian：sudo apt-get install imagemagick
  • Windows：从 ImageMagick 官方网站下载

使用方法

将以下内容添加到你的 claude_desktop_config.json：

NPX

{
  "mcpServers": {
    "mediaProcessor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-media-processor@latest"
      ]
    }
  }
}

API

工具

视频操作

• execute-ffmpeg

  • 使用自定义选项执行任意 FFmpeg 命令
  • 输入：
    • inputPath（string）：输入视频文件的绝对路径
    • options（string[]）：FFmpeg 命令选项数组
    • outputPath（string，可选）：输出文件的绝对路径
    • outputFilename（string，可选）：输出文件名

• convert-video

  • 将视频转换为其他格式
  • 输入：
    • inputPath（string）：输入视频文件的绝对路径
    • outputFormat（string）：所需的输出格式（例如 mp4、mkv、avi）
    • outputPath（string，可选）：自定义输出路径
    • outputFilename（string，可选）：自定义输出文件名

• compress-video

  • 压缩视频文件
  • 输入：
    • inputPath（string）：输入视频文件的绝对路径
    • quality（number，可选）：压缩质量（1-51，数值越低质量越好）
    • outputPath（string，可选）：自定义输出路径
    • outputFilename（string，可选）：自定义输出文件名

• trim-video

  • 将视频剪辑为指定时长
  • 输入：
    • inputPath（string）：输入视频文件的绝对路径
    • startTime（string）：开始时间，格式为 HH:MM:SS
    • duration（string）：时长，格式为 HH:MM:SS
    • outputPath（string，可选）：自定义输出路径
    • outputFilename（string，可选）：自定义输出文件名

图像操作

• compress-image

  • 使用 ImageMagick 压缩 PNG 图像
  • 输入：
    • inputPath（string）：输入 PNG 图像的绝对路径
    • quality（number，可选）：压缩质量（1-100）
    • outputPath（string，可选）：自定义输出路径
    • outputFilename（string，可选）：自定义输出文件名

• convert-image

  • 将图像转换为其他格式
  • 输入：
    • inputPath（string）：输入图像文件的绝对路径
    • outputFormat（string）：所需的输出格式（例如，jpg、png、webp、gif）
    • outputPath（string，可选）：自定义输出路径
    • outputFilename（string，可选）：自定义输出文件名

• resize-image

  • 将图像调整为指定尺寸
  • 输入：
    • inputPath（string）：输入图像文件的绝对路径
    • width（number，可选）：目标宽度（像素）
    • height（number，可选）：目标高度（像素）
    • maintainAspectRatio（boolean，可选）：是否保持宽高比
    • outputPath（string，可选）：自定义输出路径
    • outputFilename（string，可选）：自定义输出文件名

• rotate-image

  • 将图像旋转指定角度
  • 输入：
    • inputPath（string）：输入图像文件的绝对路径
    • degrees（number）：旋转角度
    • outputPath（string，可选）：自定义输出路径
    • outputFilename（string，可选）：自定义输出文件名

• add-watermark

  • 为图像添加水印
  • 输入：
    • inputPath（string）：输入图像文件的绝对路径
    • watermarkPath（string）：水印图像文件的绝对路径
    • position（string，可选）：水印位置（默认值："southeast"）
    • opacity（number，可选）：水印不透明度（0-100）
    • outputPath（string，可选）：自定义输出路径
    • outputFilename（string，可选）：自定义输出文件名

• apply-effect

  • 为图像应用视觉效果
  • 输入：
    • inputPath（string）：输入图像文件的绝对路径
    • effect（string）：要应用的效果（blur、sharpen、edge、emboss、grayscale、sepia、negate）
    • intensity（number，可选）：效果强度（0-100）
    • outputPath（string，可选）：自定义输出路径
    • outputFilename（string，可选）：自定义输出文件名

许可证

此 MCP 服务依据 MIT License 授权。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT License 的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。