BeatDesign MCP Server

<p align="center"> <img src="./docs/assets/beatdesign-readme-cover-v3.jpg" alt="BeatDesign infinite Canvas and local video Editor" width="100%" /> </p> <p align="center"> <a href="https://linux.do" alt="LINUX DO"> <img src="https://img.shields.io/badge/LINUX-DO-FFB003.svg?logo=data:image/svg%2bxml;base64,DQo8c3ZnIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgd2lkdGg9IjEwMCIgaGVpZ2h0PSIxMDAiPjxwYXRoIGQ9Ik00Ni44Mi0uMDU1aDYuMjVxMjMuOTY5IDIuMDYyIDM4IDIxLjQyNmM1LjI1OCA3LjY3NiA4LjIxNSAxNi4xNTYgOC44NzUgMjUuNDV2Ni4yNXEtMi4wNjQgMjMuOTY4LTIxLjQzIDM4LTExLjUxMiA3Ljg4NS0yNS40NDUgOC44NzRoLTYuMjVxLTIzLjk3LTIuMDY0LTM4LjAwNC0yMS40M1EuOTcxIDY3LjA1Ni0uMDU0IDUzLjE4di02LjQ3M0MxLjM2MiAzMC43ODEgOC41MDMgMTguMTQ4IDIxLjM3IDguODE3IDI5LjA0NyAzLjU2MiAzNy41MjcuNjA0IDQ2LjgyMS0uMDU2IiBzdHlsZT0ic3Ryb2tlOm5vbmU7ZmlsbC1ydWxlOmV2ZW5vZGQ7ZmlsbDojZWNlY2VjO2ZpbGwtb3BhY2l0eToxIi8+PHBhdGggZD0iTTQ3LjI2NiAyLjk1N3EyMi41My0uNjUgMzcuNzc3IDE1LjczOGE0OS43IDQ5LjcgMCAwIDEgNi44NjcgMTAuMTU3cS00MS45NjQuMjIyLTgzLjkzIDAgOS43NS0xOC42MTYgMzAuMDI0LTI0LjM4N2E2MSA2MSAwIDAgMSA5LjI2Mi0xLjUwOCIgc3R5bGU9InN0cm9rZTpub25lO2ZpbGwtcnVsZTpldmVub2RkO2ZpbGw6IzE5MTkxOTtmaWxsLW9wYWNpdHk6MSIvPjxwYXRoIGQ9Ik03Ljk4IDcwLjkyNmMyNy45NzctLjAzNSA1NS45NTQgMCA4My45My4xMTNRODMuNDI2IDg3LjQ3MyA2Ni4xMyA5NC4wODZxLTE4LjgxIDYuNTQ0LTM2LjgzMi0xLjg5OC0xNC4yMDMtNy4wOS0yMS4zMTctMjEuMjYyIiBzdHlsZT0ic3Ryb2tlOm5vbmU7ZmlsbC1ydWxlOmV2ZW5vZGQ7ZmlsbDojZjlhZjAwO2ZpbGwtb3BhY2l0eToxIi8+PC9zdmc+" /></a> </p> <h1 align="center">BeatDesign</h1> <p align="center"> <strong>Your local Higgsfield alternative.</strong><br /> Build image and video workflows on an infinite Canvas, finish them in a browser-native Editor, and let any MCP-capable Agent work in the same Project. </p> <p align="center"> <a href="https://design.beatapi.io">Website</a> · <a href="#quick-start">Quick start</a> · <a href="#use-beatdesign-with-an-agent">MCP</a> · <a href="./docs/PRODUCT_PLAN_AND_STATUS.md">Product status</a> </p> <p align="center"> <strong>English</strong> · <a href="./README.zh-CN.md">简体中文</a> · <a href="./README.ja.md">日本語</a> </p>

BeatDesign is an independent, open-source, local-first workspace for AI image and video creation. It is built for people who want the connected creative flow of tools such as Higgsfield, with a workspace they can run, inspect, and extend on their own machine.

Two creative modes, one Project

Infinite Canvas

Drop in prompts, images, video, and audio. Connect nodes, branch ideas, compare generations, reuse outputs, and keep the full visual workflow inside one project.

Video Editor

Turn Canvas results into a local timeline. Trim, split, move, mix audio, place and transform image overlays, style SRT captions, create alternate AI Takes, preview, and export MP4 in the browser.

Studio provides a focused generation surface. Assets keeps every imported and generated file available across Canvas, Editor, and MCP.

Why BeatDesign

• Local by default. Projects, media, Canvas state, timelines, and generation history stay in your local workspace.
• Canvas and Editor stay connected. A generated result becomes a reusable project Asset instead of disappearing inside one tool.
• Bring your own Agent. Codex, Claude Code, Cursor, and other MCP hosts can inspect and update the same Project you see in the browser.
• Bring your own generation access. BeatAPI is the built-in provider. Local importing, arranging, editing, previewing, and exporting do not require an API key.
• Fork-friendly foundations. Provider adapters, project storage, and the command layer are explicit extension points.

From idea to finished video

Prompt or local media
        ↓
Infinite Canvas ─── connect, generate, branch, compare
        ↓
Shared Assets ───── images, video, audio, extracted clips
        ↓
Video Editor ────── trim, arrange, preview, export MP4
        ↑
Any MCP Agent ───── works in the same local Project

Quick start

Requirements include Node.js 22+, pnpm 10+, and a current Chrome browser on macOS or Windows.

pnpm install
pnpm db:push
pnpm dev

Open http://127.0.0.1:3020.

Add your own BeatAPI API key only when you want to generate or analyze media, or use AI redo. Selecting a local file does not upload it to a provider.

Choose how to run BeatDesign

Command	Starts
pnpm dev	The visual workspace
pnpm dev:agent	The visual workspace and local HTTP MCP endpoint
pnpm mcp	The stdio MCP server for coding Agents

Use BeatDesign with an Agent

BeatDesign exposes 29 local MCP tools for Skills, Projects, Assets, Canvas, generation, and Editor operations, including built-in Skill discovery and authoritative MP4 timeline rendering. Agent changes use the same project services and become visible in the browser workspace.

After connecting your MCP host, you can ask:

Open my latest BeatDesign project, add these clips to a timeline, place the logo overlay, adjust the subtitles, and leave the Editor open for review.

Platform compatibility

Coding Agent / platform	Status	Quick setup
Claude Code	✅ Supported	Plugin or MCP config
Codex	✅ Supported	Plugin setup
ZCode	✅ Supported	MCP config
OpenCode	✅ Supported	MCP config
Cursor	✅ Supported	MCP config
Windsurf	✅ Supported	MCP config
VS Code + GitHub Copilot	✅ Supported	MCP config
Cline / Roo Code	✅ Supported	MCP config
Qwen Code	✅ Supported	MCP config
Gemini CLI	✅ Supported	MCP config
Hermes Agent	✅ Supported	MCP config
Kiro	✅ Supported	MCP config
Trae	✅ Supported	MCP config
WorkBuddy	✅ Supported	Connector setup
QwenWork	✅ Supported	HTTP connector
Doubao Work	✅ Supported	HTTP connector

Open the full Agent integration guide →

What works today

• Image and video generation plus Standard and Deep video analysis.
• Image, video, audio, generation, timeline, and text nodes on the Canvas.
• Project Assets shared across Studio, Canvas, Editor, and MCP.
• Non-destructive timeline editing with image, video, audio, movable image overlays, and styled SRT caption tracks.
• Local preview and browser-side H.264/AAC MP4 export with WebCodecs and Mediabunny.
• English, Chinese, and Japanese interfaces.
• Local stdio and Streamable HTTP MCP transports.

BeatDesign currently focuses on local, short-form creative workflows. Hosted collaboration, multiple named timelines, advanced transitions, speed controls, waveforms, and desktop packaging remain outside the current release.

See the complete shipped and planned scope →

Project guides

• Product status
• MCP setup
• Architecture
• Provider integration
• Contributing
• Security

License

BeatDesign is licensed under Apache License 2.0. BeatAPI and BeatDesign trademarks, third-party model access, and bundled third-party components remain subject to their respective terms. See third-party notices and trademark policy.