mcp-ffmpeg视频操作工具

你是否曾经希望AI能够直接处理视频文件，调整分辨率或提取音频，而无需学习复杂的FFmpeg命令？今天要介绍的开源项目mcp-ffmpeg视频操作工具，正是为了实现这个目标而设计的。它是一个启用通过自然语言请求进行视频操作的Node.js服务器，包括将视频调整为不同分辨率（360p到1080p）以及以各种格式（MP3、AAC、WAV、OGG）提取音频。

项目基本信息

一、项目介绍

mcp-ffmpeg视频操作工具是一个让AI能够通过自然语言处理视频的MCP服务器。它支持将视频调整为不同分辨率（360p、480p、720p、1080p），以及从视频中提取多种格式的音频（MP3、AAC、WAV、OGG）。

这个服务器提供了以下功能：

• 视频分辨率调整
• 音频格式提取
• 通过自然语言请求操作

二、核心优势

自然语言操作

用自然语言描述视频处理需求，无需学习FFmpeg命令。

多分辨率支持

支持360p、480p、720p、1080p。

多音频格式

支持MP3、AAC、WAV、OGG输出。

文件限制

上传文件大小限制为500MB。

MIT许可证

可自由使用和修改。

三、适用场景

视频格式转换

快速调整视频分辨率。

音频提取

从视频中提取背景音乐或人声。

内容预处理

为后续分析准备视频素材。

自动化工作流

集成到视频处理管道中。

四、安装教程

系统要求

安装FFmpeg

macOS：

brew install ffmpeg

Ubuntu/Debian：

sudo apt update
sudo apt install ffmpeg

Windows：
从ffmpeg.org下载，解压到C:\ffmpeg，将bin文件夹添加到PATH。

安装步骤

第一步：克隆项目并安装依赖

git clone https://github.com/bitscorp-mcp/mcp-ffmpeg.git
cd mcp-ffmpeg
npm install

第二步：启动服务器

npm start

开发模式：

npm run dev

第三步：配置Claude Desktop

找到配置文件，添加：

{
  "mcpServers": {
    "ffmpeg": {
      "command": "npx",
      "args": ["--yes", "/absolute/path/to/mcp-ffmpeg"]
    }
  }
}

第四步：通过Smithery安装（可选）

npx -y @smithery/cli install @bitscorp-mcp/mcp-ffmpeg --client claude

五、使用示例

示例1：调整视频分辨率

用户指令：“请将位于/path/to/video.mp4的视频调整为720p分辨率”

AI会调用相应工具处理视频。

示例2：提取音频

用户指令：“从视频中提取MP3格式的音频”

AI会调用音频提取工具。

示例3：Cursor配置

在Cursor中：
设置 -> Cursor设置 -> 功能 -> MCP服务器 -> + 添加
选择类型：命令
粘贴：

npx -y @smithery/cli@latest run @bitscorp/mcp-ffmpeg

六、文件存储

• 上传的视频临时存储在uploads目录
• 处理后的文件存储在output目录
• 文件大小限制：500MB

七、常见问题

问题1：FFmpeg未找到

解决方案：确认FFmpeg已安装并在PATH中。

问题2：文件大小超限

解决方案：限制为500MB，可修改源码。

问题3：处理失败

解决方案：检查视频格式是否支持。

问题4：Node.js版本

解决方案：需要Node.js 14或更高版本。

问题5：权限问题

解决方案：确保uploads和output目录可写。

八、总结

mcp-ffmpeg视频操作工具是一个让AI能够通过自然语言处理视频的MCP服务器，支持分辨率调整和音频提取。

这个项目的最大价值在于：

1. 自然语言操作：无需学习FFmpeg命令
2. 多分辨率支持：360p到1080p
3. 多音频格式：MP3、AAC、WAV、OGG
4. 文件限制：500MB文件大小
5. MIT许可证：可自由使用

如果你需要让AI处理视频文件，mcp-ffmpeg视频操作工具是一个非常实用的工具。