MCP 媒体处理服务器

一个实现了模型上下文协议 (MCP) 的 Node.js 服务器，用于媒体处理操作，提供强大的视频和图像处理能力。

功能

• 视频处理和转换
• 图像处理和操作
• 媒体压缩
• 视频剪辑和编辑
• 图像效果和水印

前提条件

在使用此服务器之前，请确保您的系统上已安装以下依赖项：

• 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, optional): 输出文件的绝对路径
    • outputFilename (string, optional): 输出文件名

• convert-video

  • 将视频转换为不同的格式
  • 输入:
    • inputPath (string): 输入视频文件的绝对路径
    • outputFormat (string): 期望的输出格式 (例如，mp4, mkv, avi)
    • outputPath (string, optional): 自定义输出路径
    • outputFilename (string, optional): 自定义输出文件名

• compress-video

  • 压缩视频文件
  • 输入:
    • inputPath (string): 输入视频文件的绝对路径
    • quality (number, optional): 压缩质量 (1-51, 数值越小质量越好)
    • outputPath (string, optional): 自定义输出路径
    • outputFilename (string, optional): 自定义输出文件名

• trim-video

  • 将视频剪辑到指定的持续时间
  • 输入:
    • inputPath (string): 输入视频文件的绝对路径
    • startTime (string): 开始时间，格式为 HH:MM:SS
    • duration (string): 持续时间，格式为 HH:MM:SS
    • outputPath (string, optional): 自定义输出路径
    • outputFilename (string, optional): 自定义输出文件名

图像操作

• compress-image

  • 使用 ImageMagick 压缩 PNG 图像
  • 输入:
    • inputPath (string): 输入 PNG 图像的绝对路径
    • quality (number, optional): 压缩质量 (1-100)
    • outputPath (string, optional): 自定义输出路径
    • outputFilename (string, optional): 自定义输出文件名

• convert-image

  • 将图像转换为不同的格式
  • 输入:
    • inputPath (string): 输入图像文件的绝对路径
    • outputFormat (string): 期望的输出格式 (例如，jpg, png, webp, gif)
    • outputPath (string, optional): 自定义输出路径
    • outputFilename (string, optional): 自定义输出文件名

• resize-image

  • 将图像调整为指定的尺寸
  • 输入:
    • inputPath (string): 输入图像文件的绝对路径
    • width (number, optional): 目标宽度，以像素为单位
    • height (number, optional): 目标高度，以像素为单位
    • maintainAspectRatio (boolean, optional): 是否保持宽高比
    • outputPath (string, optional): 自定义输出路径
    • outputFilename (string, optional): 自定义输出文件名

• rotate-image

  • 将图像旋转指定的度数
  • 输入:
    • inputPath (string): 输入图像文件的绝对路径
    • degrees (number): 旋转角度，以度为单位
    • outputPath (string, optional): 自定义输出路径
    • outputFilename (string, optional): 自定义输出文件名

• add-watermark

  • 向图像添加水印
  • 输入:
    • inputPath (string): 输入图像文件的绝对路径
    • watermarkPath (string): 水印图像文件的绝对路径
    • position (string, optional): 水印的位置 (默认: "southeast")
    • opacity (number, optional): 水印的不透明度 (0-100)
    • outputPath (string, optional): 自定义输出路径
    • outputFilename (string, optional): 自定义输出文件名

• apply-effect

  • 向图像应用视觉效果
  • 输入:
    • inputPath (string): 输入图像文件的绝对路径
    • effect (string): 要应用的效果 (blur, sharpen, edge, emboss, grayscale, sepia, negate)
    • intensity (number, optional): 效果强度 (0-100)
    • outputPath (string, optional): 自定义输出路径
    • outputFilename (string, optional): 自定义输出文件名

许可证

此 MCP 服务器是在 MIT 许可证下授权的。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。