Shard
Allows generating audio through kie.ai using ElevenLabs models as part of AI video and image production workflows, with jobs priced before submission.
Allows generating music through kie.ai using Suno models as part of AI video and image production workflows, with jobs priced before submission.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Shard
A motion-design studio for AI video and images, on your own computer.
Plan a film shot by shot, generate it on today's video and image models, and finish it, from a web studio, the terminal, or by asking Claude Code or Codex. Every paid job shows its price first.
English · 简体中文 · Español · 日本語 · 한국어 · Português (Brasil) · Deutsch (translations may lag behind English)
Website · A look around · Demo · Feature status · Quick start · Set up with an agent · Credits · The CLI · The MCP server · The studio
What it is
Shard is an open-source studio that runs on your computer and sends generation jobs to kie.ai, one API key for many video, image and audio models (Seedance, Kling, Veo, Wan, MiniMax, GPT Image, Nano Banana, ElevenLabs, Suno and more). You bring the key and pay kie for what you generate; Shard itself is free.
It is for people who want to make short films, ads and social clips with AI models without losing track of the plan, the characters or the bill:
Direct a film, not a prompt. Agree a brief, plan the shots with real camera terms, make a storyboard of stills, film each shot, review the takes and cut the result.
Keep people consistent. Save characters, products and places in a Library, and build character sheets so the same face comes back in every shot.
Know the cost first. Every paid job is priced before it is sent and checked against your daily and per-job limits.
Work where you like. The same tools are in the web studio, the
kiecommand line and an MCP server for coding agents.
Shard started as a fork of Chase's motion-design skill, whose ten styles live on here as the Ad templates. See Credits.
Related MCP server: Bench Studio MCP Server
A look around
What's inside
Part | What it does |
Studio ( | A local web app: Image and Video pages, films planned scene by scene, Openjutsu (beta: swap a person, outfit, object or background into any clip), AI Influencers with three-panel character sheets, a Library of characters, products and places, Looks, your skills, spend and settings. |
| Generates video, images and audio through kie.ai (WaveSpeed is an optional second route for some models), prices every job first, and keeps a record of each one. |
MCP server ( | Gives Claude Code and Codex (and Claude Desktop, with a pasted config) the same tools as the studio, so you can make films by asking. |
Render and finish ( | Draws exact graphics in code (titles, logos, numbers) with Remotion, and finishes films with ffmpeg: music, captions, loudness, other aspect ratios. |
Skill library ( | Your favourite agent skills, each usable as a |
Spending is guarded everywhere. Every paid job is priced before it is sent and checked against a daily cap and an optional per-job limit, whether it comes from the studio, the CLI or an agent. Looking things up, planning and pricing are free.
Feature status
Status | Features |
Ready | Studio (Image, Video, films scene by scene, Library, Looks, Skills, spend), AI Influencers and character sheets, the |
Experimental | Openjutsu (beta character swap), ffmpeg finishing (built and unit-tested, not yet verified on a full film), WaveSpeed routes, Claude Desktop (manual config), Linux and Windows (untested) |
Planned | ffmpeg check at startup, Silent and Loop switches, take comparison and Retry, Next beat and Coverage in Scenes, self-hosted Openjutsu |
Prices come from each provider's page on the date in cli/models.json and can go stale; the CLI warns when they are old. ROADMAP.md has the details.
Demo
A full end-to-end demo film is still to be recorded. It will show one real brief going through Shard: the plan, the storyboard, the takes, the finished cut, and the cost Shard recorded for each job. Until then, the walkthrough at the top and the screenshots are the studio itself, recorded with no generations in it and nothing spent, and no third-party video is presented as Shard output.
You can walk through most of the workflow without spending anything:
kie looks # the 17 Looks
kie plan --menu # every shot size, lens, move and light the planner knows
kie preflight --model seedance-2-5 --duration 10 # what a 10-second shot would cost, without generating
kie video --run try --model seedance-2-5 --duration 5 --look neo-noir --prompt-file idea.txt --dry-run # the prompt with the Look's words; sends nothingIn the studio, planning a film (brief, shot plan, checker) is free, and every Generate button shows its price before anything is sent.
Quick start
You need Node 22+ and a kie.ai API key. ffmpeg is needed only for finishing, and Python 3.10+ only to check the Ad templates. docs/setup.md explains each step and has a troubleshooting table.
Get the code and install the tools. The installer puts
kieon your PATH, links the skills into Claude Code, Codex and Kimi when they are installed, and registers the MCP server.git clone https://github.com/AlexMakesC0de/shard-motion-design-studio.git cd shard-motion-design-studio node install.mjs # --dry-run shows what it would change firstAdd your kie.ai key, readable only by you, then check the setup.
kie doctormakes one free balance request and generates nothing.mkdir -p ~/.config/kie printf '%s' 'YOUR_KIE_KEY' > ~/.config/kie/key && chmod 600 ~/.config/kie/key kie doctorSet a budget. For example, at most $25 a day and $2 per job:
kie limits --daily 25 --per-job 2Open the studio. It runs on http://127.0.0.1:4317 and only answers your own machine.
npm --prefix web install npm run studioOr ask an agent. Restart Claude Code or Codex and try: "Plan a 15-second product film for my app, show me the price, and don't generate anything yet." The MCP page in the studio has the exact setup command for each app.
Set it up with an AI agent
Paste this into Claude Code, Codex or another coding agent with terminal access. It installs everything, checks it and opens the studio, and it is told not to spend anything.
Set up Shard, the motion-design studio at https://github.com/AlexMakesC0de/shard-motion-design-studio, on this computer.
1. Check that Node 22 or newer is installed. If it isn't, tell me how to install it and stop.
2. Clone the repository into a folder I can find (ask me where if unsure), then cd into it.
3. Run `node install.mjs --dry-run`, show me what it would change, and wait for my OK. Then run `node install.mjs`.
4. Tell me to create a kie.ai API key at https://kie.ai and save it myself with:
mkdir -p ~/.config/kie && printf '%s' 'MY_KEY' > ~/.config/kie/key && chmod 600 ~/.config/kie/key
Never ask me to paste the key into this chat, and never read or print the key file.
5. When I say it's saved, run `kie doctor` (one free balance check, generates nothing) and show me the result.
6. Ask me for a daily spending limit and a per-job limit, then set them with `kie limits --daily <amount> --per-job <amount>`.
7. Run `npm --prefix web install`, then start the studio with `npm run studio` and give me the address (http://127.0.0.1:4317).
8. If ffmpeg is missing, tell me it's only needed for finishing films and how to install it; don't install it unasked.
Do not generate any image, video or audio, and do not spend money at any step. Finish with a short summary of what was installed and what I can try first.Make something from the terminal
kie looks # the 17 Looks
kie presets # the ten Ad templates
kie preflight --model seedance-2-5 --duration 10 # what a job would cost, without spending
kie video --run launch --preset kinetic-typography --duration 10
kie render --run launch --template logo-reveal --props brand.json
kie assemble --run launch --shot out.mp4 --shot logo-reveal.mp4 --transition fade:0.5
kie variants --run launch --video film.mp4 --ratios 9:16,1:1kie render needs Remotion, installed once with npm --prefix render install. kie assemble, kie caption and kie variants need ffmpeg.
Generated video is photographic: it invents plausible pixels. Anything that has to be exactly right, like a headline, a logo or a price, is better drawn by kie render and laid over the film. graphic-motion.md explains when to use which.
Your films, takes and spend records stay in runs/, and saved references in library/. Both are ignored by git.
The Looks
A Look sets the camera, light, colour, pacing and sound for a shot in one pick, on any video model. Shard ships 17, listed by kie looks, in the studio's Looks page and through MCP. The previews below were made for Shard.
Shard also keeps the ten Ad templates from Chase's original skill (kie presets): full source prompts with adaptation guides, for example a glass UI launch or an exploded product. They are his work and are not under the MIT licence; see Licence.
Credits
Chase (@cth9191) made the original motion-design skill this project grew out of: the ten Ad templates, their source prompts and the adaptation guides. If you like them, give his repo a star.
The Ad templates' source prompts first appeared in a Higgsfield Marketing Studio article.
The Claude and OpenAI icons on the MCP page are from LobeHub Icons (MIT).
ATTRIBUTION.md lists exactly which files came from Chase's repo.
Licence
Shard's own code and docs are under the MIT licence: the studio, the kie CLI, the MCP server, the render and finishing engines, the installer, the Looks and their previews, the director guides, the tests and the docs.
The Ad templates and the other files from Chase's repo are not covered by the MIT licence. His repo has no licence, so they are his, included here with credit until he grants permission or they are replaced. ATTRIBUTION.md lists them. If you redistribute Shard, leave them out or ask him first.
Tests
npm test # CLI
npm run test:mcp # MCP server
npm run test:web # studio
npm run validate # the Ad templates: source hashes, templates and galleryTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
AI video editor for agents and humans: timeline, captions, color, audio and generation as MCP tools.
AI film studio: your stories, shots and edits, plus Unreal and Unity orders, from your account.
Plan, compare, price, generate, and recover AI video from compatible MCP clients.
AI video generation MCP server for Kling, MiniMax, Luma & Hunyuan with prompt blueprints.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server that provides a local Web production console and HTTP control plane for AI video creation, exposing tools for project/revision management, media analysis, editing, review, and delivery while keeping formal rendering behind explicit approval gates.-
- AlicenseNot gradedqualityCmaintenanceA local-first creative studio MCP server that provides access to 73 curated image and video generation models across 5 providers, enabling users to generate, refine, and manage creative outputs with transparent cost tracking and local file custody.5MIT
- AlicenseCqualityBmaintenanceOpen-source local-first AI media workbench with Canvas, video editor, Assets, and MCP control.38367Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to direct a local media studio over MCP, generating consistent characters, photocards, album art, and beat-synced music videos by orchestrating ComfyUI, ffmpeg, and Piper TTS while recording the full recipe of every asset.MIT