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，请转到设置 -> 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 以使更改生效。

Claude 的示例提示

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

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

注意事项

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

许可证

MIT