halfsize
halfsize is a Node.js command-line tool that compresses a video to a target file size, such as 20 MB for a Discord upload, using FFmpeg on the user's machine.
What it does
halfsize is a Node.js command-line tool that compresses a video to a target file size, such as 20 MB for a Discord upload, using FFmpeg on the user's machine. It converts HDR footage to SDR and can report quality with SSIM and VMAF scores. Run with the --mcp flag it becomes a local MCP server over stdio with one tool, compress_video, which takes the input file, target size and optional output path, codec and quality check, and returns the same JSON report as the CLI. The README says compression never uses the network; the only download is an optional FFmpeg fetch. No API key is needed.
Capabilities
- Compress a video to a target file size
- Convert HDR video to SDR
- Report SSIM and VMAF quality scores
About
- Publisher
- YKLovePython
Install
- Add this to Any client's configuration:
{ "mcpServers": { "halfsize": { "command": "npx", "args": ["-y", "halfsize", "--mcp"] } } }
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | Image and video generation | |
| Publisher | YKLovePython | source |
| Official status | Not stated in its documentation | |
| Connection | Local (runs on your computer) | source |
| Can change data | Not stated in its documentation | |
| Needs an API key or sign-in | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Claude Desktop, Cursor, Visual Studio Code | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 15, 2026104 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Also listed under: Image and video generation
Sources
- GitHub repositorygithub.com/yklovepython/halfsize · Backs: AI clients, Connection, Licence, Needs an API key or sign-in, Publisher, ActivityNov 16, 2026
- GitHub API recordgithub.com/YKLovePython/halfsizeNov 16, 2026