返回 MCP 目录
public公开dns本地运行

mcp-ffmpeg

一个基于Node.js和FFmpeg的视频处理服务器,提供视频转码和音频提取功能

article

README

🚀 MCP FFmpeg 视频处理器

这是一个基于 Node.js 构建的服务器,借助 FFmpeg 强大的功能来处理视频文件。它提供了丰富的 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 安装 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 许可证

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端