HoneyVid MCP server
Commit 12 Nov 2026Hasilkan video dan gambar AI yang viral menggunakan model seperti Kling dan Veo melalui template atau prompt kustom dan foto referensi.
Juga dikenal sebagai HoneyVid/cli, cli
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 1.0.1
- Commit terakhir
- 12 Nov 2026
- Lisensi
- MIT
Apa itu HoneyVid MCP?
HoneyVid adalah MCP server. Hasilkan video dan gambar AI yang viral menggunakan model seperti Kling dan Veo melalui template atau prompt kustom dan foto referensi.
Ringkasan dibuat dari README proyek
Tentang HoneyVid MCP server
HoneyVid memungkinkan Anda membuat video dan gambar AI yang viral langsung dari lingkungan pengembangan Anda. Developer dan AI agent dapat menghasilkan media berkualitas tinggi menggunakan model canggih seperti Kling dan Veo dengan memanfaatkan template yang sudah ada atau prompt playground kustom. Sistem ini juga mendukung penambahan foto referensi untuk menjaga konsistensi karakter di berbagai hasil generasi.
User dapat terhubung melalui koneksi remote MCP menggunakan setup Streamable HTTP yang memerlukan OAuth tanpa perlu manajemen API key secara manual. Untuk workflow lokal, Node.js CLI memungkinkan login interaktif melalui browser atau mode headless untuk mesin remote. Tool ini mengelola kredit akun dan menyediakan idempotency key untuk memastikan bahwa kegagalan jaringan tidak menyebabkan penagihan ganda yang tidak disengaja saat melakukan tugas pembuatan video atau gambar.
Apa yang bisa Anda lakukan dengannya
- 1Menjaga konsistensi karakterAnda dapat mengunggah foto referensi untuk digunakan sebagai karakter dalam tugas pembuatan gambar maupun video.
- 2Otomatisasi media workflow di CIDeveloper dapat menggunakan refresh token untuk menjalankan command pembuatan di lingkungan otomatis tanpa memerlukan browser.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal HoneyVid MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal HoneyVid MCP di Claude Code
$ claude mcp add --transport http cli https://honeyvid.ai/mcpInstal HoneyVid MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"url": "https://honeyvid.ai/mcp"
}
}
}Instal HoneyVid MCP di VS Code
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "http",
"url": "https://honeyvid.ai/mcp"
}
}
}Instal HoneyVid MCP di VS Code CLI
$ code --add-mcp '{"name":"cli","type":"http","url":"https://honeyvid.ai/mcp"}'Instal HoneyVid MCP di Codex
$ codex mcp add cli --url https://honeyvid.ai/mcpInstal HoneyVid MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.cli] url = "https://honeyvid.ai/mcp"
Instal HoneyVid MCP di Gemini CLI
$ gemini mcp add -s user --transport http cli https://honeyvid.ai/mcpInstal HoneyVid MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"url": "https://honeyvid.ai/mcp",
"type": "http"
}
}
}Pengecekan otomatis
Berjalan 15 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauhoneyvid/cli is public and reachablegithub.com/honeyvid/cli ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-12github.com/honeyvid/cli ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPHTTPS endpoint answered 401 (sign-in required)Lolos
README
Lihat di GitHubHoneyVid CLI for agents
Use HoneyVid from Claude Code, Codex, Cursor, shell scripts, or another agent. Create from a template or use Playground video and image models with your own prompt, settings, and reference photos. Generation uses account credits and usually takes 2–10 minutes.
Node.js 20 or newer. Plain ESM, no build step, no runtime dependencies. Published on npm as honeyvid:
npx honeyvid --help
# Or install globally:
npm install -g honeyvid
honeyvid --help
honeyvid schema
Prefer a remote MCP connection instead? Add https://honeyvid.ai/mcp (Streamable HTTP, OAuth, no API key) to your MCP client. Setup for every app: https://honeyvid.ai/mcp
Claude Code users can install the HoneyVid plugin (MCP server plus skills) from HoneyVid/skills: /plugin marketplace add HoneyVid/skills, then /plugin install honeyvid@honeyvid.
Sign in
honeyvid login
honeyvid whoami
Login prints a URL and an eight-character code, such as HVQK-7M2P, and opens the system browser when available. Check the code on HoneyVid matches your terminal, then click Connect. The browser shows Connected with the same code. The CLI finishes by itself and prints your account. No copy-paste or local listener is needed. Login lasts 10 minutes and uses PKCE S256 with no client secret.
For an agent, SSH, or a machine without a browser:
honeyvid login --no-browser
# Open data.url on any browser, check data.code, and click Connect.
# Leave the command running; it finishes after approval.
Piped output and --json print a JSON envelope immediately with {url, code, expiresInSeconds: 600, next: "Open the url and click Connect. Check the code matches."}, then a second envelope with the account after approval. In a terminal, the URL and code go to stderr. The CLI polls every two seconds. --no-browser skips opening the browser and still waits.
If the process stops, resume the same saved login within its original 10 minutes:
honeyvid login --wait
Use the same config directory and base URL. The saved verifier and state stay private in the local auth file; approval requires the verifier to exchange the code. login --code '<long-oauth-code>' remains as a legacy fallback for one release if you already copied an OAuth code. The new browser page shows only the short matching code, which is not an OAuth code.
Tokens are stored per base URL at ${XDG_CONFIG_HOME:-~/.config}/honeyvid/auth.json (file 0600, directory 0700). Expiring tokens refresh before requests; a 401 refreshes once and replays the request once. Rotated refresh tokens are saved atomically. A config lock serializes refreshes and writes so parallel commands share the latest rotating token. Queued jobs are exposed as processing.
honeyvid auth export --json
honeyvid logout
auth export returns data.refreshToken and warns on stderr. Treat it as a secret. HONEYVID_TOKEN supplies a refresh token for CI and overrides the local login. Its rotated credentials are cached separately, so later commands on the same machine use the new token without replacing the interactive login. Export the current token when moving CI to another machine. Never put tokens in source control, shared logs, or prompts. Logout removes local credentials for the selected base URL; it does not revoke a token or unset HONEYVID_TOKEN.
Template flow
honeyvid templates --search dance --limit 10 --json
honeyvid template '<template-id>'
honeyvid characters add ./face.jpg --name Alex
# Or:
honeyvid characters add --url 'https://example.com/face.jpg' --name Alex
honeyvid characters
honeyvid quote --template '<template-id>' --quality standard
honeyvid create --template '<template-id>' --character '<character-id>' \
--quality standard --max-credits 50 --idempotency-key 'my-video-001' \
--wait --timeout 600 --output ./video.mp4
Use IDs and prices returned by the API. Choose a template with available qualities. Template results contain compact details and absolute poster and preview URLs. Character uploads accept PNG, JPG, and WebP up to 10 MB; names contain 1–60 characters. URL images must use HTTPS and are downloaded without account credentials.
--max-credits is required for create and retry. The server must enforce this ceiling and reject a higher price with 409. A quote does not reserve a price or credits. --dry-run returns the same output as quote, does not submit a job, and needs only the source and quality:
honeyvid create --template '<template-id>' --quality high --dry-run
Create, retry, and generate always print the idempotency key to stderr before submission and include it as data.idempotencyKey or error.idempotencyKey. On a network failure, timeout, or server error, the outcome may be unknown: rerun the same command with the same key and inputs. A new key can create and charge for another job. There are no automatic retries for 429, network errors, or 5xx responses.
honeyvid video '<job-id>' --wait --timeout 600
honeyvid job '<job-id>' # Alias for video
honeyvid videos --status completed --limit 10
honeyvid download '<job-id>' # ./honeyvid-<id>.mp4
honeyvid retry '<failed-job-id>' --max-credits 50 \
--idempotency-key 'my-retry-001' --wait
honeyvid account # Credits, plan, topUpUrl
Wait checks every five seconds and writes progress to stderr. A timeout stops waiting; it does not cancel generation. Output paths are absolute in results. The response Content-Type sets the file extension; a mismatched extension is replaced and the actual path is reported on stderr and in JSON. Downloads stream to a temporary file, never overwrite an existing destination, and remove partial files on failure. --output on create, video, or retry downloads after completion; add --wait if the video is processing.
For your own source video:
honeyvid upload ./clip.mp4
honeyvid quote --upload '<upload-id>' --quality standard
honeyvid create --upload '<upload-id>' --character '<character-id>' \
--quality standard --max-credits 50 --wait --output ./my-video.mp4
Use an MP4 up to 100 MB and 3–30 seconds. Uploads stream as raw video/mp4 with a content length, not multipart. Own-video generation may be unavailable for the account. Choose exactly one of --template and --upload.
Playground flow
Discover the models available to the signed-in account, then inspect the selected model's full fields. Model availability and settings come from the server; do not guess model IDs or supported values.
honeyvid models --kind video
honeyvid models --kind image
honeyvid models --model '<model-id>' --json
honeyvid characters add ./reference.jpg --name Reference
honeyvid generate video --model '<model-id>' --prompt 'A honey river at sunrise' \
--set duration=5 --image '<character-id>:start' --max-credits 50 --dry-run
honeyvid generate video --model '<model-id>' --prompt 'A honey river at sunrise' \
--set duration=5 --image '<character-id>:start' --max-credits 50 \
--idempotency-key 'playground-video-001' --wait --timeout 600 --output ./river.mp4
honeyvid generate image --model '<image-model-id>' --prompt 'A honey jar in warm light' \
--image '<character-id>' --max-credits 50 --dry-run
honeyvid generate image --model '<image-model-id>' --prompt 'A honey jar in warm light' \
--image '<character-id>' --max-credits 50 \
--idempotency-key 'playground-image-001' --wait --output ./jar.png
The settings above are examples; use fields returned by models --model for the selected model. Repeat --set key=value for each setting. Numbers (including decimals, negatives, and exponents) and lowercase true/false become JSON numbers and booleans. Other values stay strings. Duplicate setting keys are rejected. Video references accept --image <character-id>[:start|end|ref]; image generation accepts character IDs without roles. Repeat --image for more references. If the model accepts a source video, add --video upload:<id> or --video template:<id>.
Both generate commands require --model, --prompt, and --max-credits, including for --dry-run. A dry run calls the free Playground quote endpoint and returns credits, balance, and estimatedSeconds; it creates no job. A real run sends the cap to the server. A price above it returns exit 5 without charging. Quotes do not reserve prices.
Generate prints a caller-supplied or generated idempotency key before submitting and returns it in success or error JSON. Reuse the same key and inputs after an uncertain outcome. Waiting and downloading work like template creation.
honeyvid videos --kind image
honeyvid video '<image-job-id>'
honeyvid video '<image-job-id>' --wait --output ./image.png
Every job returned by create, generate, retry, video, or videos includes accountUrl. Share this lasting link with the user to open the saved result in their HoneyVid account after sign-in. resultUrl and image URLs are temporary links for previews and downloads; their expiry does not delete saved media. Read the job again to refresh them without generating or paying again.
Image job output also includes image URLs. The first image is saved at --output; more images use image-2.png, image-3.png, and so on. Results include path for the first download and paths for all downloads. Existing files are preserved. In a terminal, models prints a compact table; --model prints the full schema. Piped output and --json always use JSON envelopes.
Agent skills
honeyvid skills list
honeyvid skills install # Claude and Codex
honeyvid skills install --agent claude
honeyvid skills install --agent codex
honeyvid skills install --agent all
honeyvid skills install --dir ./skills
These commands work without login. Bundled skills use HoneyVid MCP tools when connected and the CLI otherwise. The installer copies all bundled skill folders into $HOME/.claude/skills/<name>/ and/or $HOME/.codex/skills/<name>/. --dir overrides the skills root and installs once into <dir>/<name>/, regardless of --agent.
The JSON result lists written absolute paths in paths and preserved paths in skipped. A small .honeyvid-cli.json ownership file lets later installs update only files previously written by this installer. Existing user files, edited installed files, extra files, and skill directory symlinks are preserved. The installer never deletes user files or prompts.
Machine interface
Every command accepts --json; it is the default when stdout is not a TTY. JSON commands print one envelope, except login, which prints connection details before its final account or error envelope:
{"ok":true,"data":{"credits":12,"quality":"standard","estimatedSeconds":120,"balance":100}}
Failures print one envelope to stdout and exit nonzero:
{"ok":false,"error":{"code":"not_signed_in","message":"You are not signed in.","suggestion":"Run honeyvid login.","retryable":false}}
Errors can also contain idempotencyKey, jobId, and retryAfter (seconds). retryable describes the error; the CLI does not automatically retry it. Never parse stderr as data. Help is plain text. schema returns all commands, flags, enums, constraints, output shapes, environment variables, and exit codes in data. Every command has --help, examples, environment variables, and exit codes.
Known API error codes are price_above_max (409 with credits), insufficient_credits (402), rate_limited (429), generation_closed, not_found (404), and forbidden (403). Their exit codes follow the table below: credit, limit and conflict errors use 5; forbidden uses 1.
| Exit | Meaning | Agent action |
|---|---|---|
| 0 | Success | Read data. |
| 1 | Request, network, file, or other error | Read the suggestion; preserve a submitted key. |
| 2 | Usage error | Read command help. |
| 3 | Not signed in | Run honeyvid login. |
| 4 | Not found | Check the ID and base URL. |
| 5 | Credits, limits, conflict, or price above maximum | Read the error. For 429, respect retryAfter and reuse the key. |
| 6 | Job failed | Inspect the job; quote and retry if wanted. |
| 7 | Wait timed out; job still running | Run honeyvid video <id> --wait. |
Environment:
HONEYVID_URL: API/site base URL; defaults tohttps://honeyvid.ai.--base-url <url>overrides it. HTTPS is required except for loopback development URLs. Credentials are isolated by base URL.HONEYVID_TOKEN: secret refresh token overriding stored login.HOME: home directory for agent skills (or the OS home if unset).XDG_CONFIG_HOME: parent of thehoneyvid/config directory.DISPLAY: when absent on Linux, login prints a Connect URL instead of opening a browser.
The CLI never prompts. It never publishes, tops up credits, or changes subscription plans.
Remote MCP setup
honeyvid setup all
honeyvid setup claude --apply
honeyvid setup codex
honeyvid setup cursor
Setup also suggests honeyvid skills install. The endpoint is <base>/mcp. Claude setup prints claude mcp add --transport http honeyvid <url>; --apply runs it if Claude is on PATH. Codex setup prints the ~/.codex/config.toml block. Cursor setup prints the ~/.cursor/mcp.json block. The CLI never edits these config files itself.
Development
This repository is the source of the honeyvid CLI; pull requests are welcome.
npm ci --ignore-scripts
scripts/fetch-skills.sh # copies HoneyVid/skills at the commit in skills.ref into ./skills
npm test
node bin/honeyvid.mjs --help
node bin/honeyvid.mjs schema
Tests start a local fake HTTP server and use temporary config directories. They do not call a real account, spend credits, or generate real videos.
Releasing: bump version in package.json and merge to main. The Release workflow publishes to npm by trusted publishing (no tokens) with the skills pinned in skills.ref. Changing server.json (bump its version) republishes the official MCP Registry entry ai.honeyvid/honeyvid.
Pertanyaan tentang HoneyVid MCP
Bagaimana cara menambahkan HoneyVid MCP ke Claude Code?
Jalankan claude mcp add --transport http cli https://honeyvid.ai/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan HoneyVid MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Berapa lama waktu yang dibutuhkan untuk pembuatan video?
Proses pembuatan biasanya memakan waktu antara 2 hingga 10 menit.
Bagaimana cara login ke HoneyVid?
Anda dapat menggunakan command 'honeyvid login', yang akan memberikan URL dan kode delapan karakter untuk dicocokkan di browser Anda.
Bisakah saya menggunakan video sumber saya sendiri untuk pembuatan?
Ya, Anda dapat mengunggah file MP4 hingga 100 MB dengan durasi antara 3 hingga 30 detik.
Apa yang terjadi jika terjadi kesalahan jaringan saat pengiriman job?
Jika terjadi kegagalan jaringan atau error pada server, Anda harus menjalankan kembali command yang sama menggunakan idempotency key dan input yang sama.