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 的示例提示

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

使用 ffmpeg MCP 服务器，请将 /path/to/video.mp4 的视频调整为 720p 分辨率。

注意

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

许可证

MIT