← Back to Music Media MCP Server

Install Music Media MCP Server

Pick your client, copy the command, done.

Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

git clone https://github.com/joshndala/music-media-mcp.git
cd music-media-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
2

Register it in Claude Code

claude mcp add -e "GCP_PROJECT_ID=${GCP_PROJECT_ID}" -e "GCS_BUCKET_NAME=${GCS_BUCKET_NAME}" music-media -- /path/to/.venv/bin/python /path/to/server.py --transport stdio

Replace any placeholder paths in the command with the real path on your machine.

Required:GCP_PROJECT_IDGCS_BUCKET_NAME+ 1 optional

Environment Variables

Set these before running Music Media MCP Server.

VariableDescriptionRequired
GCP_PROJECT_IDGoogle Cloud project IDYes
GCS_BUCKET_NAMEGCS bucket for video uploadsYes
GCP_LOCATIONVertex AI regionNo

Available Tools (1)

Once configured, Music Media MCP Server gives your AI agent access to:

generate_and_merge_mediaGenerates a music track based on visual content and merges it with the source media into a video artifact.
source_media_urlmusic_prompt

Try It Out

After setup, try these prompts with your AI agent:

Generate a music video for this image: [URL] with an upbeat electronic dance music style.
Create a 30-second soundtrack for this video: [URL] using a calm ambient piano style.
Analyze this image [URL] and generate a fitting cinematic orchestral soundtrack for it.
Create a music video for [URL] using a soaring strings orchestral score.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Python 3.8+ with pip installed
  • GCP_PROJECT_ID — Google Cloud project ID
  • GCS_BUCKET_NAME — GCS bucket for video uploads
Conare · memory for coding agents

Keep this setup from going cold

Save the docs, env vars, and workflow around Music Media MCP Server in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup$npx conare@latest