使用Veo2进行MCP视频生成

该项目实现了一个模型上下文协议（MCP）服务器，该服务器公开了Google的Veo2视频生成能力。它允许客户端从文本提示或图像生成视频，并通过MCP资源访问生成的视频。

<a href="https://glama.ai/mcp/servers/@mario-andreschak/mcp-veo2"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=1525196113,820361528&fm=3081&app=3081&f=PNG?w=760&h=400" alt="使用Veo2 MCP服务器生成视频" /> </a>

功能

• 从文本提示生成视频
• 从图像生成视频
• 通过MCP资源访问生成的视频
• 示例视频生成模板
• 支持stdio和SSE传输方式

示例图像

示例图像到视频

图像到视频 - 来自Grok生成的小狗

图像到视频 - 来自真实猫咪

预备条件

• Node.js 18或更高版本
• 具有访问Gemini API和Veo2模型权限的Google API密钥（= 您需要在API密钥中设置信用卡！-> 前往aistudio.google.com）

安装

在FLUJO中安装

1. 点击添加服务器
2. 将GitHub URL复制并粘贴到FLUJO中
3. 点击解析、克隆、安装、构建并保存。

通过Smithery安装

要通过Smithery自动安装mcp-video-generation-veo2到Claude桌面：

npx -y @smithery/cli install @mario-andreschak/mcp-veo2 --client claude

手动安装

1. 克隆仓库：

   git clone https://github.com/yourusername/mcp-video-generation-veo2.git
   cd mcp-video-generation-veo2
   

2. 安装依赖项：

   npm install
   

3. 创建一个包含您的Google API密钥的.env文件：

   cp .env.example .env
   # 编辑.env并添加您的Google API密钥
   

   .env文件支持以下变量：

   • GOOGLE_API_KEY：您的Google API密钥（必需）
   • PORT：服务器端口（默认：3000）
   • STORAGE_DIR：存储生成视频的目录（默认：./generated-videos）
   • LOG_LEVEL：日志级别（默认：fatal）
     • 可用级别：verbose, debug, info, warn, error, fatal, none
     • 开发时，设置为debug或info以获得更详细的日志
     • 生产环境中，保持为fatal以最小化控制台输出

4. 构建项目：

   npm run build
   

使用方法

启动服务器

您可以使用stdio或SSE传输方式启动服务器：

stdio传输方式（默认）

npm start
# 或
npm start stdio

SSE传输方式

npm start sse

这将在端口3000（或您.env文件中指定的端口）上启动服务器。

MCP工具

服务器公开了以下MCP工具：

generateVideoFromText

根据文本提示生成视频。

参数：

• prompt（字符串）：用于视频生成的文本提示
• config（对象，可选）：配置选项
  • aspectRatio（字符串，可选）："16:9"或"9:16"
  • personGeneration（字符串，可选）："dont_allow"或"allow_adult"
  • numberOfVideos（数字，可选）：1或2
  • durationSeconds（数字，可选）：介于5到8之间
  • enhancePrompt（布尔值，可选）：是否增强提示
  • negativePrompt（字符串，可选）：描述不希望生成的内容的文本

示例：

{
  "prompt": "全景镜头拍摄宁静森林，阳光透过树木，具有电影质感",
  "config": {
    "aspectRatio": "16:9",
    "personGeneration": "dont_allow",
    "durationSeconds": 8
  }
}

generateVideoFromImage

根据图像生成视频。

参数：

• image（字符串）：Base64编码的图像数据
• prompt（字符串，可选）：引导视频生成的文本提示
• config（对象，可选）：配置选项（与上述相同，但personGeneration仅支持"dont_allow"）

listGeneratedVideos

列出所有生成的视频。

MCP资源

服务器公开了以下MCP资源：

videos://{id}

通过ID访问生成的视频。

videos://templates

访问示例视频生成模板。

开发

项目结构

• src/：源代码
  • index.ts：主入口点
  • server.ts：MCP服务器配置
  • config.ts：配置处理
  • tools/：MCP工具实现
  • resources/：MCP资源实现
  • services/：外部服务集成
  • utils/：实用函数

构建

npm run build

开发模式

npm run dev

许可证

MIT