c-brooks/Fillet

Fillet

FFMPEG-powered MCP server for intelligent video operations.

Quickstart

Build

Build binary named fillet:

go build -o fillet .

Claude

1. Edit ~/.config/Claude/claude_desktop_config.json (macOS) or appropriate path for your OS:

   {
     "mcpServers": {
       "fillet": {
         "command": "/path/to/fillet/binary",
         "args": [],
         "disabled": false
       }
     }
   }
   

   Replace /path/to/fillet/binary with the actual path to your built binary.

2. Restart Claude Desktop to make Fillet available.

Example 1: Prepare a command

"Create an ffmpeg command that trims video.mp4 from 10 seconds to 30 seconds and transcodes it with libx264 codec at medium preset"

Claude will call prepareCommand and return the exact command string.

Example 2: Chain operations

"I want to resize a 4K video down to 1080p, reduce the frame rate to 24fps, and transcode with H.265 codec"

Claude will call prepareCommand with resize, framerate, and transcode operations.

Manual Testing: MCP Inspector

Setup MCP Inspector

1. Install Node.js (if not already installed)

2. Install MCP Inspector globally:

   npm install -g @modelcontextprotocol/inspector
   

3. Build your fillet server:

   go build -o fillet .
   

Launch Inspector

npx @modelcontextprotocol/inspector ./fillet

This opens a web UI at http://localhost:3000 where you can:

• See all available tools (prepareCommand, executeCommand, checkJobStatus)
• View the JSON schema for each tool
• Send test requests to your server
• See responses and errors in real-time

Unit Tests

go test -v ./...