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

1. 安装依赖项：

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. 将 FFmpeg MCP 服务器添加到 mcpServers 部分：

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

如果您已将包发布到 npm：

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

1. 重启 Claude Desktop 以使更改生效。

Claude 示例提示

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

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

注意事项

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

许可证

MIT