JinDaGe - mcp-ffmpeg MCP Details

article

README

🚀 MCP FFmpeg 视频处理器

这是一个基于 Node.js 构建的服务器，借助 FFmpeg 强大的功能来处理视频文件。它提供了丰富的 API，能将视频缩放为不同分辨率，还能从视频中提取音频并转换为多种常见格式，为视频处理工作带来了极大便利。

🚀 快速开始

在使用这个视频处理器之前，需要完成一些准备工作，下面将详细介绍。

✨ 主要特性

视频分辨率缩放：可以将视频缩放为不同分辨率，如 360p、480p、720p、1080p。
音频提取与转换：能够从视频中提取音频，并将其转换为多种格式，包括 MP3、AAC、WAV、OGG。

📦 安装指南

先决条件

在运行此应用程序之前，您需要安装以下内容：

Node.js（v14 或更高版本）
FFmpeg - 此工具用于视频处理

安装 FFmpeg

在 macOS 上：

brew install ffmpeg

在 Ubuntu/Debian 上：

sudo apt update
sudo apt install ffmpeg

在 Windows 上：

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

安装项目

克隆此仓库：

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

安装依赖项：

npm install

通过 Smithery 安装

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

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

💻 使用示例

运行服务器

使用以下命令启动服务器：

npm start

在开发环境中，使用带有自动重启的文件更改检测：

npm run dev

通过 Smithery 安装用于 Cursor

要安装 mcp-ffmpeg 用于 Cursor，请前往设置 -> Cursor 设置 -> 功能 -> MCP 服务器 -> + 添加。选择类型：命令，粘贴以下内容：

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

使用与 Claude 桌面集成

| 属性 | 详情 | |------|------| | 端点 | http://localhost:3000 | | API 文档 | /api-docs | | 配置文件路径 | C:\Users\%username%\.claude\config.json | | Claude 版本 | latest |

📚 详细文档

注意事项

上传和处理的文件将临时存储在以下位置：
- Windows：C:\Users\%username%\AppData\Local\Temp
- macOS 和 Linux：/tmp
最大允许文件大小为 100 MB。

📄 许可证

本项目采用 MIT 许可证。

mcp-ffmpeg