mcp-ffmpeg

MCP FFmpeg 视频处理器

一个使用 FFmpeg 处理视频文件的 Node.js 服务。此服务提供以下 API：

• 将视频调整为不同分辨率（360p、480p、720p、1080p）
• 以多种格式（MP3、AAC、WAV、OGG）从视频中提取音频

先决条件

运行此应用之前，需要安装以下软件：

1. Node.js（v14 或更高版本）
2. FFmpeg —— 视频处理必需

安装 FFmpeg

在 macOS 上：

brew install ffmpeg

在 Ubuntu/Debian 上：

sudo apt update
sudo apt install ffmpeg

在 Windows 上：

1. 从官方网站下载 FFmpeg
2. 将文件解压到一个文件夹（例如 C:\ffmpeg）
3. 将 bin 文件夹添加到 PATH 环境变量中

安装

1. 克隆此仓库：

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

2. 安装依赖项：

npm install

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 mcp-ffmpeg：

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

运行服务

使用以下命令启动服务：

npm start

如需在文件更改时自动重启以进行开发：

npm run dev

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 mcp-ffmpeg：

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

如需为 Cursor 安装 mcp-ffmpeg，请前往 Settings -> Cursor Settings -> Features -> MCP Servers -> + Add

选择 Type: command，并粘贴以下内容，使用你从 Adjust 获取的 API 密钥

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

与 Claude Desktop 配合使用

此 MCP FFmpeg 服务可集成到 Claude Desktop 中，通过自然语言请求处理视频。

使用 npx 运行

你可以直接使用 npx 运行此服务：

npx /path/to/mcp-ffmpeg

或者，如果你已将软件包发布到 npm：

npx mcp-ffmpeg

配置 Claude Desktop

如需将此服务添加到 Claude Desktop，请更新 Claude Desktop 配置文件：

1. 找到 Claude Desktop 配置文件：

   • macOS：~/.config/claude-desktop/config.json 或 ~/Library/Application Support/Claude Desktop/config.json
   • Windows：%APPDATA%\Claude Desktop\config.json
   • Linux：~/.config/claude-desktop/config.json

2. 将 FFmpeg MCP 服务添加到 mcpServers 部分：

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

如果你已将软件包发布到 npm：

{
    "mcpServers": {
        "ffmpeg": {
            "command": "npx",
            "args": [
                "--yes",
                "mcp-ffmpeg"
            ]
        }
    }
}

3. 重启 Claude Desktop，使更改生效。

Claude 提示词示例

配置完成后，你可以使用如下提示词：

Using the ffmpeg MCP server, please resize the video at /path/to/video.mp4 to 720p resolution.

备注

• 上传的视频会临时存储在 uploads 目录中
• 处理后的视频和音频文件存储在 output 目录中
• 服务的上传文件大小限制为 500MB

许可证

MIT