MCP Video Generation with Veo2

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

功能

• 从文本提示生成视频
• 从图像生成视频
• 通过 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 自动为 Claude Desktop 安装 mcp-video-generation-veo2：

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
# or
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": "Panning wide shot of a serene forest with sunlight filtering through the trees, cinematic quality",
  "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