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 自动安装 mcp-ffmpeg 到 Claude Desktop：

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

运行服务器

启动服务器：

npm start

为了在开发时自动重启文件更改：

npm run dev

通过 Smithery 安装

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

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

要在 Cursor 中安装 mcp-ffmpeg，请转到设置 -> Cursor 设置 -> 功能 -> MCP 服务器 -> + 添加

选择类型：命令，并粘贴以下内容，使用来自 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. 在 mcpServers 部分添加 FFmpeg MCP 服务器：

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

如果你已经将包发布到 npm：

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

3. 重新启动 Claude Desktop 以使更改生效。

示例提示

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

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

注意事项

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

许可证

MIT