Hs MCP server

hs · Huasheng CLI

From one sentence to a finished, publishable video

简体中文 · English

hs brings Huasheng's video creation pipeline to the command line. Give it a sentence or a script, and it handles storyboarding, narration, footage and composition — producing a video you can export or publish directly. You can step in and adjust at any point along the way.

A single self-contained binary. No Node, no Python, no runtime to install. Every command supports --json, designed for scripts and AI clients.

Step 1: install and sign in

Do this once, regardless of which client you use later.

Install

Pick whichever suits you — all three give you the same binary.

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/superlcr/huasheng-cli/main/install.sh | sh

Windows, in PowerShell:

irm https://raw.githubusercontent.com/superlcr/huasheng-cli/main/install.ps1 | iex

Either installer downloads the package for your platform, verifies its SHA256, and extracts it to ~/.local/bin (%LOCALAPPDATA%\Programs\hs on Windows).

With npm, if you already live in the Node ecosystem or just want to try it first:

npx @superlcr/hs --help
npm install -g @superlcr/hs    # the command is still `hs`

The npm package is a small launcher; the binary for your platform arrives as an optional dependency, so nothing is downloaded or compiled at install time.

Manual download instead of the installer

Grab the package for your platform from Releases, extract it, and place the executable anywhere on your PATH:

Every release ships a SHA256SUMS file. Verifying it is recommended:

shasum -a 256 -c SHA256SUMS

Both macOS packages are signed and notarized by Apple (Developer ID Application).

The Windows package is unsigned; SmartScreen may prompt on first run — choose

"More info → Run anyway".

Sign in

Open a new terminal, sign in, and confirm that hs can read your credit balance:

hs auth login
hs account

The CLI and every AI client share ~/.hs/credentials.json; you do not sign in separately.

No browser on that machine (SSH, a cloud server, a container)? Run hs auth login --no-browser, open the address it prints on any device, approve, and paste back the address the browser lands on (it starts with http://127.0.0.1 and will not load — that is expected).

Step 2: choose how you use it

Both paths use the same hs binary and the same sign-in — pick either, or both.

Option 1: use hs CLI directly

Use this path for exact commands, scripts, or batch jobs. hs make can start from one sentence or a complete script, run the creation workflow, wait for the finished video, and download it.

Create a video from one sentence:

hs make --script "Three little-known facts about West Lake" --out ./out.mp4

Request an MG-style video:

hs make --script "Explain Song dynasty tea whisking in 30 seconds" --mode mg --out ./tea.mp4

Read a long script from a file:

hs make --script @script.txt --out ./video.mp4

Or start from your own narration recording — a file on your computer or a public URL:

Shortened. The full README is on GitHub.