mcp-ffmpeg-tools
2025.05.08
0
Python媒体处理视频编辑音频处理开发效率内容生成
mcp-ffmpeg-tools 是一个开源的 Python MCP（Model-Command Protocol）服务器，旨在使大型语言模型（LLMs）能够执行 FFmpeg 命令、接收执行结果，并根据 FFmpeg 源代码验证命令。该工具支持跨平台（Windows、macOS、Linux），并提供环境管理功能。
View on GitHub
Overview
基本能力
产品定位
mcp-ffmpeg-tools 是一个用于媒体处理和转换的工具，通过 MCP 接口使 LLMs 能够执行 FFmpeg 命令并验证其正确性。
核心功能
- 通过 MCP 接口执行 FFmpeg 命令
- 接收详细的执行结果和错误消息
- 访问 FFmpeg 源代码以验证命令
- 跨平台支持（Windows、macOS、Linux）
- 使用 uv 进行环境管理
适用场景
- 媒体文件的转换和处理
- 视频和音频流的提取
- 视频叠加和编辑
- 媒体文件的质量检查和分析
工具列表
execute_ffmpeg: 执行 FFmpeg 命令execute_ffprobe: 检查结果（如分辨率、比特率）get_screenshot: 检查结果（如视频布局、质量）ls_ffmpeg_source_code和get_ffmpeg_source_code: 使用 FFmpeg 源代码验证命令
常见问题解答
- FFmpeg 未安装: 确保 FFmpeg 已安装并添加到系统 PATH 中。
- 安装失败: 检查 FFmpeg 是否安装正确，以及源代码下载是否成功。
使用教程
使用依赖
Windows
- 从 ffmpeg.org 下载 FFmpeg
- 解压到指定位置
- 将
bin目录添加到系统 PATH
macOS
brew install ffmpeg
Linux (Ubuntu/Debian)
sudo apt update
sudo apt install ffmpeg
Linux (Fedora)
sudo dnf install ffmpeg
安装教程
- 克隆仓库:
git clone https://github.com/gamhoi/mcp-ffmpeg-tools.git
cd mcp-ffmpeg-tools
- 使用 uv 安装:
uv venv
uv pip install -e .
调试方式
运行测试
uv run python3 client/test.py
使用 Claude Desktop
在 Claude Desktop 设置中添加以下配置:
{
"mcpServers": {
"mcp-ffmpeg-tools": {
"command": "uv",
"args": [
"--directory",
"PATH_TO/mcp-ffmpeg-tools",
"run",
"ffmpeg-tools"
]
}
}
}