ffmpeg-mcp

FFmpeg MCP Server — 将常用 FFmpeg 操作封装为 MCP 工具，支持 AI 助手直接调用。

功能特性

支持 17 个实用 FFmpeg 工具：

传输模式

前置条件

• Node.js >= 18

• FFmpeg 已安装并在 PATH 中（运行 ffmpeg -version 验证）

安装

npm install
npm run build

客户端配置

Claude Code

claude mcp add ffmpeg-mcp -- node /path/to/ffmpeg-mcp/dist/index.js

或在 ~/.claude/settings.json 中：

{
  "mcpServers": {
    "ffmpeg": {
      "command": "node",
      "args": ["/path/to/ffmpeg-mcp/dist/index.js"]
    }
  }
}

Cursor

在 .cursor/mcp.json 中：

{
  "mcpServers": {
    "ffmpeg": {
      "command": "node",
      "args": ["/path/to/ffmpeg-mcp/dist/index.js"]
    }
  }
}

Windsurf

在 ~/.codeium/windsurf/mcp_config.json 中：

{
  "mcpServers": {
    "ffmpeg": {
      "command": "node",
      "args": ["/path/to/ffmpeg-mcp/dist/index.js"]
    }
  }
}

HTTP/SSE 模式（通用 Web 客户端）

# 启动 SSE 服务
node dist/index.js --transport sse --port 3100

# 启动 Streamable HTTP 服务
node dist/index.js --transport http --port 3100

SSE 端点: http://127.0.0.1:3100/sse HTTP 端点: http://127.0.0.1:3100/mcp

使用示例

配置好客户端后，AI 助手可以直接使用自然语言调用：

• "帮我查看这个视频的信息" → probe

• "把这个 AVI 转成 MP4" → convert

• "压缩这个视频到更小的体积" → compress

• "从视频中提取音频为 MP3" → extract_audio

• "截取视频第 30 秒的缩略图" → thumbnail

• "裁剪视频从 1 分钟到 3 分钟" → trim

• "把这几个视频合并成一个" → merge

• "给视频右下角加个水印" → watermark

• "把视频片段转成 GIF" → gif

• "把视频缩放到 720p" → resize

• "把视频 2 倍速播放" → speed

• "把视频旋转 90 度" → rotate

• "给视频换一个背景音乐" → add_audio

• "给视频加上字幕" → subtitle

• "把音量调大一倍" → volume

• "裁剪视频中间的画面" → crop

• "每秒提取一帧图片" → frames

命令行参数

--transport <stdio|sse|http>  传输模式（默认 stdio）
--port <number>               端口号（默认 3100）
--host <string>               绑定地址（默认 127.0.0.1）

License

MIT