storytelling-media-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@storytelling-media-mcp Generate a 5-second video of a sunset over mountains."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Storytelling Media MCP
MCP tools for an agent-driven video creation workflow.
This server gives Codex, Claude Code, or another MCP client access to:
Nano Banana image generation and editing through Google's GenAI SDK.
Veo 3.1 video generation through Google's GenAI SDK.
Local video stitching through FFmpeg.
Models
Image generation defaults to the newer Google image models:
flash:gemini-3.1-flash-imagealso described by Google as Nano Banana 2.pro:gemini-3-pro-imagealso described by Google as Nano Banana Pro.legacy_flash:gemini-2.5-flash-imagefor older Nano Banana workflows.
Video generation defaults to:
veo-3.1-generate-001
Related MCP server: Sora 2 MCP Server
Setup
python -m venv .venv
. .venv/bin/activate
pip install -e .
cp .env.template .envFFmpeg must be installed and available on PATH for stitching.
ADC Instead of API Key
The Gemini API can also use OAuth/ADC, but the ADC login must include Google's Gemini scope:
gcloud auth application-default login \
--scopes='https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/generative-language.retriever'
gcloud auth application-default set-quota-project "$GOOGLE_CLOUD_PROJECT"Then run the MCP server with GOOGLE_CLOUD_PROJECT set to the project that should be used for quota and billing:
python -m storytelling_mcpThe server also accepts GOOGLE_CLOUD_QUOTA_PROJECT or GCLOUD_PROJECT. Then call the image or video tools with auth_mode="adc". If your ADC token was created without the generative-language.retriever scope, the Gemini API returns ACCESS_TOKEN_SCOPE_INSUFFICIENT.
Run
python -m storytelling_mcpMCP Client Config
Example stdio server config using an API key:
{
"mcpServers": {
"storytelling-media": {
"command": "python",
"args": ["-m", "storytelling_mcp"],
"env": {
"GEMINI_API_KEY": "your_api_key"
}
}
}
}Example stdio server config using ADC/Vertex:
{
"mcpServers": {
"storytelling-media": {
"command": "python",
"args": ["-m", "storytelling_mcp"],
"env": {
"GOOGLE_CLOUD_PROJECT": "your-gcp-project-id",
"GOOGLE_CLOUD_LOCATION": "us-central1"
}
}
}
}Agent Plugins
This repo includes installable plugin metadata for both Claude Code and Codex.
Claude Code:
/plugin marketplace add imyousuf/storytelling-media-mcp
/plugin install storytelling-media-mcp@storytelling-mediaCodex:
codex plugin marketplace add imyousuf/storytelling-media-mcp --sparse .agents/plugins --sparse pluginsThen open /plugins in Codex and install storytelling-media-mcp from the storytelling-media marketplace.
The plugin launcher uses STORYTELLING_MEDIA_MCP_ROOT for local development. If that variable is unset, it creates a plugin-local virtual environment and installs this package from GitHub before starting the MCP server.
The plugin also includes $movie-production-pipeline, a gated multi-agent workflow for turning a director's brief into stage-approved production artifacts. It expects user feedback at each stage before moving forward.
Tools
nano_banana_generate_image: text-to-image or text-and-image-to-image.veo_generate_video: text-to-video, image-to-video, interpolation, or reference-image-guided generation.stitch_videos: concatenate local MP4 clips with FFmpeg.
Generated files are written to paths supplied by the caller.
Available Tools
3 toolsnano_banana_generate_imageB
Generate or edit an image with Google's Nano Banana Gemini image models.
Inputs: prompt (required), output_path (required), model, auth_mode, +2 more. Returns: object
stitch_videosA
Stitch local video files into one output file with FFmpeg.
Inputs: input_paths (required), output_path (required), reencode. Returns: object
veo_generate_videoC
Generate a video with Google's Veo 3.1 Gemini API.
Inputs: prompt (required), output_path (required), model, auth_mode, +9 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: image generation, video generation, and video stitching. No overlap or ambiguity between them.
The first two tools follow a 'model_verb_object' pattern, while the third uses a simpler 'verb_object' pattern. This is a minor deviation, but the names remain predictable and readable.
Three tools cover the core media generation and stitching workflows. The count is on the low side but each tool serves a distinct, necessary function without being overly sparse.
The toolkit covers image generation, video generation, and video stitching, which are fundamental for storytelling media. Minor gaps exist, such as missing audio generation or video editing, but the core generation-to-assembly flow is well represented.
Maintenance
Related MCP Connectors
Transform video, audio and images, and generate media from prompts. FFmpeg, captions, models.
FFmpeg as a service for AI agents: typed video editing tools, async jobs, downloadable outputs.
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
AI image + video generation for agents: --flag prompt DSL, async generate/poll, x402 pay-per-use.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides tools to interact with RunwayML and Luma AI APIs for video and image generation, including text-to-video, image-to-video, prompt enhancement, and management of generations.18ISC
- AlicenseAqualityDmaintenanceEnables video generation through OpenAI's Sora 2 API, allowing users to create, monitor, and manage AI-generated videos. It also provides tools for merging video clips and creating fade animations from static images using FFmpeg.615 npm2MIT
- FlicenseAqualityBmaintenanceEnables AI agents to generate videos from text prompts, monitor job status, retrieve completed videos, and cancel ongoing generation tasks through stdio-based MCP tools.4-
- AlicenseBqualityCmaintenanceEnables AI agents to programmatically edit videos via FFmpeg, providing tools for probing, trimming, concatenating, timeline composition, LUT generation/application, rendering, and edit verification over MCP.162MIT