fluvie_mcp 0.1.1

An MCP server that lets an AI assistant author and render Fluvie videos, over stdio or HTTP.

fluvie_mcp

Let an AI assistant direct Fluvie for you. This is a Model Context Protocol (MCP) server: point Claude (Desktop or Code) at it and ask for a video in plain language. It authors a spec, renders it, and hands back a download link.

The rendering happens on a running Fluvie render API, so this package carries no Flutter or FFmpeg. It is a thin, tiny adapter between an assistant and your renderer.

Tools

Tool	What it does
generate_video	Author a video from a prompt and render it.
edit_video	Refine an existing VideoSpec with a plain-language change.
render_video	Render a VideoSpec you already have.
render_composition	Render a composition registered in the project by key.
get_video_spec_schema	Fetch the VideoSpec JSON Schema to author against.

Run it

Set where your render API lives, then start the server.

export FLUVIE_API_URL=https://api.fluvie.dev   # your render API
export FLUVIE_API_TOKEN=your-render-token       # if the API needs one

# stdio (for a local assistant)
dart run fluvie_mcp

# or over HTTP (for a hosted endpoint)
dart run fluvie_mcp --http   # honours HOST, PORT, FLUVIE_MCP_TOKEN

Connect Claude Code

# local, over stdio
claude mcp add fluvie -- dart run fluvie_mcp

# remote, over HTTP
claude mcp add --transport http fluvie https://mcp.fluvie.dev/mcp \
  --header "Authorization: Bearer $FLUVIE_MCP_TOKEN"

Then ask: "make me a 6 second vertical title card on a dark gradient, fade the headline in." The assistant calls generate_video and replies with a link.

Configuration

Variable	Meaning	Default
FLUVIE_API_URL	Render API base URL	http://localhost:8080
FLUVIE_API_TOKEN	Bearer token for the render API	none
FLUVIE_MCP_TOKEN	Bearer token required on the HTTP endpoint	none (open)
HOST / PORT	Where --http binds	0.0.0.0 / 8080

Documentation

See the Fluvie AI and MCP guide.

License

MIT. See LICENSE.