使用说明

视频mcp

Claude Code的完整视频制作工具包。通过人工智能分析、画外音生成、音乐创作和远程渲染创建专业视频。

安装

通过市场（推荐）

# Add the Video Media Marketplace
claude mcp add-marketplace https://github.com/TerminalGravity/video-media-marketplace.git

# Install video-mcp
claude plugins install video-mcp

手动安装

添加到 ~/.claude.json:

{
  "mcpServers": {
    "video-mcp": {
      "command": "node",
      "args": ["/path/to/video-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-key",
        "ELEVENLABS_API_KEY": "your-elevenlabs-key",
        "FREESOUND_API_KEY": "your-freesound-key",
        "MUBERT_API_KEY": "your-mubert-key"
      }
    }
  }
}

特性

类别	工具	需要API
视频分析	`analyze_video`, `critique_design`, `suggest_improvements`	双子座（免费）
旁白	`generate_voiceover`, `list_voices`, `list_gemini_voices`, `script_voiceover`	Gemini（免费）或ElevenLabs
音频搜索	`search_sounds`, `download_sound`, `get_trending_sounds`	Freesound（免费）
AI音乐	`generate_music`, `list_mubert_tags`	穆伯特
音乐提示	`generate_music_prompt`, `generate_sfx_prompt`	无（适用于Suno）
渲染	`render_video`, `list_compositions`	远程CLI

API密钥

密钥	必需	成本	获取
`GEMINI_API_KEY`	是	免费	谷歌AI工作室
`ELEVENLABS_API_KEY`	否	已支付	十一实验室
`FREESOUND_API_KEY`	否	免费	自由之声
`MUBERT_API_KEY`	否	已支付	API穆伯特

快速示例

分析视频

claude "Analyze my video at ./demo.mp4 for marketing effectiveness"

生成画外音

# Uses Gemini TTS (free) or falls back to ElevenLabs
claude "Generate a voiceover saying 'Welcome to our product' and save to ./audio/vo.mp3"

查找背景音乐

claude "Find upbeat electronic music around 60 seconds for a tech demo"

渲染远程视频

claude "Render the MainVideo composition from ./my-project to ./out/final.mp4"

工具参考

视频分析（Gemini）

`analyze_video`

分析视频的营销效果、设计质量和改进。

analyze_video video_path=./out/hero.mp4 video_type=hero target_platform=youtube

参数：

video_type：英雄、预告片、展示、社交、教程
target_platform：youtube、twitter、linkedin、instagram、网站、tiktok

`critique_design`

获得关于颜色、排版和动画的专家设计批评。

critique_design video_path=./out/hero.mp4 focus_areas=["animations","typography","colors"]

`suggest_improvements`

通过远程代码提示获得可操作的改进。

suggest_improvements video_path=./out/hero.mp4 goals=["engagement","clarity"]

画外音（双子座TTS+ElevenLabs）

`generate_voiceover`

生成画外音音频。默认情况下使用Gemini TTS，如果配置了，则回退到ElevenLabs。

generate_voiceover text="Welcome to our demo" output_path=./audio/vo.mp3

参数：

text：要发言的文本
output_path：保存音频文件的位置
voice_id：ElevenLabs语音ID（可选）
stability, similarity_boost, style：ElevenLabs语音设置

`list_gemini_voices`

列出可用的Gemini TTS语音。

语音	描述
Kore	温暖明亮的女声
Puck	欢快的男声
Charon	深沉、成熟的男声
Fenrir	大胆自信的男声
Aoede	清晰、口齿伶俐的女声
Leda	温柔、年轻的女声
Orus	坚定、稳定的男声
Zephyr	中性、平衡的声音

`list_voices`

列出ElevenLabs可用的声音。

`script_voiceover`

分析视频并生成定时画外音脚本。

script_voiceover video_path=./out/hero.mp4 product_name=MyApp tone=professional

音频搜索（自由声音）

`search_sounds`

在Freesound.org上搜索免版税音乐和SFX。

search_sounds query="upbeat electronic" filter="duration:[30 TO 90]" sort=downloads_desc

参数：

query：搜索词
filter：Solr滤波器（例如。， duration:[10 TO 60])
sort：分数、持续时间_desc、持续时间_asc、创建desc、下载desc、评分_desc
page_size：每页结果（最多50个）

`download_sound`

按ID从Freesound下载声音。

download_sound sound_id=12345 output_path=./audio/music.mp3 quality=preview-hq-mp3

`get_trending_sounds`

使用免版税的替代品获得热门的TikTok/社交媒体声音风格。

get_trending_sounds category=music region=US limit=10

AI音乐（穆伯特）

`generate_music`

使用Mubert生成AI背景音乐。

generate_music output_path=./audio/music.mp3 prompt="upbeat electronic tech" duration=30

参数：

prompt：所需音乐的文字描述
tags：Mubert标签数组
duration：10-180秒
mode：轨道或循环（无缝循环）

`list_mubert_tags`

按类别列出所有可用的Mubert标签。

常见组合：

用例	标签
技术演示	电子、现代、乐观
企业	企业，鼓舞人心，光明
教程	lofi，冷静，极简
Epic Launch	电影、史诗、管弦乐

音乐提示（Suno Fallback）

当Mubert不可用时使用这些选项-生成粘贴到的提示 suno.com.

`generate_music_prompt`

generate_music_prompt mood=techy energy=medium duration=30

`generate_sfx_prompt`

generate_sfx_prompt effect_type=whoosh
generate_sfx_prompt effect_type=custom custom_description="futuristic button click"

渲染（远程）

`render_video`

将远程作品渲染为MP4。

render_video project_path=./my-video composition=MainVideo output_path=./out/video.mp4

`list_compositions`

列出远程项目中的所有作品。

list_compositions project_path=./my-video

完成工作流程

1.创建您的搬家项目

npx create-video@latest my-video
cd my-video
npm run dev  # Preview at localhost:3000

2.渲染初始视频

claude "List compositions in ./my-video and render the main one to ./out/draft.mp4"

3.分析和改进

claude "Analyze ./out/draft.mp4 and suggest improvements for YouTube engagement"

4.生成音频

画外音：

claude "Generate a voiceover script for ./out/draft.mp4 then generate the audio to ./public/audio/vo.mp3"

背景音乐：

claude "Find calm electronic music around 60 seconds and download to ./public/audio/music.mp3"

5.在作曲中添加音频

import { Audio, Sequence, staticFile, interpolate, useCurrentFrame } from 'remotion';

export const MyVideo: React.FC = () => {
  const frame = useCurrentFrame();

  // Duck music during voiceover
  const musicVolume = interpolate(
    frame,
    [0, 30, 40, 470, 480, 540],
    [0.7, 0.7, 0.25, 0.25, 0.7, 0.7],
    { extrapolateRight: 'clamp' }
  );

  return (
    <AbsoluteFill>
      <MainContent />

      {/* Background music */}
      <Audio src={staticFile('audio/music.mp3')} volume={musicVolume} loop />

      {/* Voiceover at 1 second */}
      <Sequence from={30}>
        <Audio src={staticFile('audio/vo.mp3')} />
      </Sequence>
    </AbsoluteFill>
  );
};

6.最终渲染

claude "Render the final video to ./out/final.mp4"

环境变量

变量	必填	默认	描述
`GEMINI_API_KEY`	是	-	Google Gemini API密钥
`ELEVENLABS_API_KEY`	否	-	ElevenLabs API密钥（高级TTS）
`FREESOUND_API_KEY`	否	-	Freesound API密钥
`MUBERT_API_KEY`	否	-	Mubert API密钥
`GEMINI_MODEL`	没有	`gemini-2.0-flash`	Gemini分析模型

从源头构建

git clone https://github.com/TerminalGravity/video-mcp.git
cd video-mcp
npm install
npm run build

故障排除

“GEMINI_API_KEY未配置”

将Gemini API密钥添加到中的MCP服务器环境 ~/.claude.json.

配音失败

先试用Gemini TTS（免费）。如果失败，请确保ElevenLabs密钥已配置为回退。

Freesound下载失败

在获取免费API密钥 freesound.org/apiv2/apply.

Mubert一代超时

Mubert异步生成曲目。较长的曲目（60秒以上）可能需要2-3分钟。

渲染失败

确保您指向的是一个有效的远程处理项目 src/index.ts 或 src/index.tsx.

Claude代码技能

此插件包括 video-from-code 简化视频创作的技能。安装后，Claude可以：

分析您的代码项目并建议视频内容
根据您的特征创建Remotion作品
使用音频生成完整的视频工作流程

许可证

MIT© 终端重力

Part of the Video Media Marketplace

使用说明

视频mcp

安装

通过市场（推荐）

手动安装

特性

API密钥

快速示例

分析视频

生成画外音

查找背景音乐

渲染远程视频

工具参考

视频分析（Gemini）

analyze_video

critique_design

suggest_improvements

画外音（双子座TTS+ElevenLabs）

generate_voiceover

list_gemini_voices

list_voices

script_voiceover

音频搜索（自由声音）

search_sounds

download_sound

get_trending_sounds

AI音乐（穆伯特）

generate_music

list_mubert_tags

音乐提示（Suno Fallback）

generate_music_prompt

generate_sfx_prompt

渲染（远程）

render_video

list_compositions

完成工作流程

1.创建您的搬家项目

2.渲染初始视频

3.分析和改进

4.生成音频

5.在作曲中添加音频

6.最终渲染

环境变量

从源头构建

故障排除

“GEMINI_API_KEY未配置”

配音失败

Freesound下载失败

Mubert一代超时

渲染失败

Claude代码技能

许可证

相关 MCP

多模态生成API服务

文本转语音服务

语音合成服务器

AI模型访问服务

语音生成集成

文本转语音 MCP 服务器

`analyze_video`

`critique_design`

`suggest_improvements`

`generate_voiceover`

`list_gemini_voices`

`list_voices`

`script_voiceover`

`search_sounds`

`download_sound`

`get_trending_sounds`

`generate_music`

`list_mubert_tags`

`generate_music_prompt`

`generate_sfx_prompt`

`render_video`

`list_compositions`