Installing FFmpeg

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

bitscorp-mcp / mcp-ffmpeg Public

• Notifications
  You must be signed in to change notification settings

• Fork 1

• Star 6

6 stars
1 fork
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

bitscorp-mcp/mcp-ffmpeg

main

2 Branches
0 Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------


oivoodoo

fix typo

Mar 16, 2025

994268c
 · Mar 16, 2025

History
-------

19 Commits

| | |
| dist | | dist | 1.0.5 | Mar 13, 2025 |
| src | | src | change mcp server | Mar 13, 2025 |
| .gitignore | | .gitignore | add dist | Mar 13, 2025 |
| Dockerfile | | Dockerfile | Merge branch 'main' into smithery/config-cgca | Mar 14, 2025 |
| README.md | | README.md | fix typo | Mar 16, 2025 |
| eslint.config.js | | eslint.config.js | change mcp server | Mar 13, 2025 |
| package-lock.json | | package-lock.json | fix typo | Mar 16, 2025 |
| package.json | | package.json | updated | Mar 14, 2025 |
| smithery.yaml | | smithery.yaml | Add Smithery configuration | Mar 14, 2025 |
| tsconfig.json | | tsconfig.json | change mcp server | Mar 13, 2025 |
| View all files | | |

Repository files navigation

MCP FFmpeg Video Processor

A Node.js server that uses FFmpeg to manipulate video files. This server provides APIs to:

• Resize videos to different resolutions (360p, 480p, 720p, 1080p)
• Extract audio from videos in various formats (MP3, AAC, WAV, OGG)

Prerequisites

Before running this application, you need to have the following installed:

1. Node.js (v14 or higher)
2. FFmpeg - This is required for video processing

Installing FFmpeg

On macOS:

brew install ffmpeg

On Ubuntu/Debian:

sudo apt update
sudo apt install ffmpeg

On Windows:

1. Download FFmpeg from the official website

2. Extract the files to a folder (e.g., C:\ffmpeg)

3. Add the bin folder to your PATH environment variable

Installation

1. Clone this repository:

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

1. Install dependencies:

npm install

Installing via Smithery

To install mcp-ffmpeg for Claude Desktop automatically via Smithery
:

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

Running the Server

Start the server with:

npm start

For development with auto-restart on file changes:

npm run dev

Installing via Smithery

To install mcp-ffmpeg for Claude Desktop automatically via Smithery
:

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

To install mcp-ffmpeg for Cursor, go to Settings -> Cursor Settings -> Features -> MCP Servers -> + Add

Select Type: command and paste the below, using your API key from Adjust

npx -y @smithery/cli@latest run @bitscorp/mcp-ffmpeg

Using with Claude Desktop

This MCP FFmpeg server can be integrated with Claude Desktop to process videos through natural language requests.

Running with npx

You can run the server directly with npx:

npx /path/to/mcp-ffmpeg

Or if you've published the package to npm:

npx mcp-ffmpeg

Configuring Claude Desktop

To add this server to Claude Desktop, update your Claude Desktop configuration file:

1. Locate your Claude Desktop config file:

   • macOS: ~/.config/claude-desktop/config.json or ~/Library/Application Support/Claude Desktop/config.json
   • Windows: %APPDATA%\Claude Desktop\config.json
   • Linux: ~/.config/claude-desktop/config.json
   • Add the FFmpeg MCP server to the mcpServers section:

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

If you've published the package to npm:

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

1. Restart Claude Desktop for the changes to take effect.

Example Prompts for Claude

Once configured, you can use prompts like:

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

Notes

• Uploaded videos are stored temporarily in the uploads directory
• Processed videos and audio files are stored in the output directory
• The server has a file size limit of 500MB for uploads

License

MIT

About

No description, website, or topics provided.

Resources

Readme

Activity

Custom properties

Stars

6 stars

Watchers

1 watching

Forks

1 fork

Report repository

Releases

No releases published

Packages 0

No packages published

Contributors 2

• 
  oivoodoo Alex

• 
  smithery-ai[bot]

Languages

• TypeScript 93.1%

• Dockerfile 6.2%

• JavaScript 0.7%

You can’t perform that action at this time.