halfsize

● Active

io.github.YKLovePython/halfsize

Compress a video to an exact byte size locally with FFmpeg, then measure VMAF and SSIM.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "halfsize": {
      "command": "npx",
      "args": [
        "-y",
        "halfsize@0.2.0",
        "--mcp"
      ]
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add halfsize -- npx -y halfsize@0.2.0 --mcp
OpenAI Codex CLI
codex mcp add halfsize -- npx -y halfsize@0.2.0 --mcp
VS Code
code --add-mcp '{"name":"halfsize","type":"stdio","command":"npx","args":["-y","halfsize@0.2.0","--mcp"]}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Media & Creative
Version
0.2.0
Registry
active
Published
11/19/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 21, 2026

Looks healthy: halfsize is maintained, open source.

Maintained
Active
Last commit 4 days ago (Nov 18, 2026), 0 open issues.
Official registry
Active
Published as io.github.YKLovePython/halfsize in the official MCP registry, version 0.2.0.
Source
Open source, MIT
Public repository under the MIT licence, 110 stars, 8 forks.
Runs
On your machine
A local npm package started by your client; it can reach whatever your user account can.
Credentials
None declared
The registry entry declares no required environment variables.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 18, 2026
Stars
110
Forks
8
Last push
Nov 18, 2026
License
MIT

HTMLclicompress-videodiscordemail-attachmentffmpeghdrlocal-firstmacosmcpmcp-servernodejsofflineprivacytarget-sizevideo-compressionvideo-compressorvmafwechatwhatsappwindows

From the README

halfsize Compress any video to any size. Locally. And keep the quality. 中文说明 · Website & guides · Quick start · How it works · FAQ As featured in 阮一峰《科技爱好者周刊》第 418 期 · 2,500+ downloads on npm New in 0.1.13: --mcp is listed in the official MCP Registry , so Claude Code, Cursor and VS Code can discover it instead of having a config pasted in. Release notes WeChat and Discord both stop at 20 MB. Email chokes around the same. So you open a video editor, guess a bitrate, export, check the size, export again, and still can't tell whether the picture got worse. halfsize turns that into one command: It computes the bitrate, picks the resolution that actually fits, encodes twice, then measures the result with SSIM and VMAF so you know whether it still looks the same. Why this exists "Make it smaller" is a solved problem. "Make it fit in exactly 20 MB, and tell me if it still looks right" is the part every tool makes you guess at. • HandBrake is excellent, but it asks you to think in codecs, RF values, and presets. • Online compressors work until you remember you just uploaded a private video to a stranger. • ffmpeg can do all of this. Nobody remembers the 11 flags, and almost nobody checks VMAF afterwards. halfsize is the missing 5%: a target size you type, and a quality score you can read. Quick start Requires Node.js 18+.…

Read the full README on GitHub →

The most-starred Media & Creative servers in the index, with their live-check result.

ServerStarsLast pushLive check
HyperFrames by HeyGen87,943Nov 2026Needs sign-in
HyperFrames by HeyGen86,475Nov 2026Needs sign-in
Pascal 3D Editor25,651Nov 2026Needs sign-in
screenpipe22,421Nov 2026Local / not checked
FunASR21,097Nov 2026Local / not checked

halfsize: questions people ask

Is halfsize a remote or a local MCP server?
According to its entry in the official MCP registry, halfsize ships as a local package (npm) that your client starts on your machine.
Is halfsize safe to use?
Looks healthy: halfsize is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: None declared. Serverdex check of Nov 21, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is halfsize still maintained?
Active: the repository's last commit 4 days ago. Last push Nov 18, 2026, 110 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
How do I add halfsize to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Media & Creative →

Add the badge to your site

Show visitors that halfsize is listed here — it’s also the link we check for a free listing.

halfsize — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-yklovepython-halfsize?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="halfsize — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![halfsize — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-yklovepython-halfsize?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-yklovepython-halfsize) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-yklovepython-halfsize) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-yklovepython-halfsize)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-yklovepython-halfsize"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-yklovepython-halfsize"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-yklovepython-halfsize"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).