MCP 媒体处理服务器

一个基于Node.js的服务器，实现了用于媒体处理操作的模型上下文协议（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 (字符串)：输入视频文件的绝对路径
    • options (字符串数组)：FFmpeg命令选项数组
    • outputPath (字符串，可选)：输出文件的绝对路径
    • outputFilename (字符串，可选)：输出文件名

• convert-video

  • 将视频转换为不同的格式
  • 输入参数：
    • inputPath (字符串)：输入视频文件的绝对路径
    • outputFormat (字符串)：期望的输出格式（例如，mp4, mkv, avi）
    • outputPath (字符串，可选)：自定义输出路径
    • outputFilename (字符串，可选)：自定义输出文件名

• compress-video

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

• trim-video

  • 将视频剪辑至指定时长
  • 输入参数：
    • inputPath (字符串)：输入视频文件的绝对路径
    • startTime (字符串)：开始时间，格式为HH:MM:SS
    • duration (字符串)：持续时间，格式为HH:MM:SS
    • outputPath (字符串，可选)：自定义输出路径
    • outputFilename (字符串，可选)：自定义输出文件名

图像操作

• compress-image

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

• convert-image

  • 将图像转换为不同的格式
  • 输入参数：
    • inputPath (字符串)：输入图像文件的绝对路径
    • outputFormat (字符串)：期望的输出格式（例如，jpg, png, webp, gif）
    • outputPath (字符串，可选)：自定义输出路径
    • outputFilename (字符串，可选)：自定义输出文件名

• resize-image

  • 将图像调整至指定尺寸
  • 输入参数：
    • inputPath (字符串)：输入图像文件的绝对路径
    • width (数字，可选)：目标宽度（像素）
    • height (数字，可选)：目标高度（像素）
    • maintainAspectRatio (布尔值，可选)：是否保持宽高比
    • outputPath (字符串，可选)：自定义输出路径
    • outputFilename (字符串，可选)：自定义输出文件名

• rotate-image

  • 将图像旋转指定角度
  • 输入参数：
    • inputPath (字符串)：输入图像文件的绝对路径
    • degrees (数字)：旋转角度（度数）
    • outputPath (字符串，可选)：自定义输出路径
    • outputFilename (字符串，可选)：自定义输出文件名

• add-watermark

  • 向图像添加水印
  • 输入参数：
    • inputPath (字符串)：输入图像文件的绝对路径
    • watermarkPath (字符串)：水印图像文件的绝对路径
    • position (字符串，可选)：水印位置（默认："southeast"）
    • opacity (数字，可选)：水印透明度（0-100）
    • outputPath (字符串，可选)：自定义输出路径
    • outputFilename (字符串，可选)：自定义输出文件名

• apply-effect

  • 应用视觉效果至图像
  • 输入参数：
    • inputPath (字符串)：输入图像文件的绝对路径
    • effect (字符串)：要应用的效果（模糊、锐化、边缘检测、浮雕、灰度、棕褐色、反色）
    • intensity (数字，可选)：效果强度（0-100）
    • outputPath (字符串，可选)：自定义输出路径
    • outputFilename (字符串，可选)：自定义输出文件名

许可证

此MCP服务器采用MIT许可证。这意味着您可以自由地使用、修改和分发该软件，但需遵守MIT许可证中的条款和条件。更多详情，请参阅项目仓库中的LICENSE文件。