JinDaGe - mcp-veo2 MCP Details

article

README

🚀 使用 Veo2 的 MCP 视频生成

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

🚀 快速开始

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

✨ 主要特性

视频生成：支持从文本提示和图像生成高质量视频。
资源访问：通过独特的资源标识符（如 videos://{id}）访问生成的视频，并提供示例模板。
灵活配置：提供多种配置选项，包括宽高比、人物生成策略、时长等。

📦 安装指南

项目依赖

确保安装以下工具和库：

Node.js（推荐版本 14+）
npm 或 yarn
TypeScript（可选但推荐）

克隆仓库

git clone https://github.com/your-repository.git
cd mcp-video-generation-with_veo2

安装依赖

npm install
# 或者使用 yarn
yarn install

💻 使用示例

基础用法

初始化服务器

运行以下命令启动 MCP 服务器：

node src/index.ts

调用工具

从文本生成

{
  "prompt": "宏伟的城市夜景，灯光闪烁",
  "config": {
    "aspectRatio": "16:9",
    "personGeneration": "dont_allow",
    "durationSeconds": 8
  }
}

从图像生成

{
  "image": "base64 编码的图像数据...",
  "prompt": "沙漠日落"
}

列出所有生成视频

访问资源 videos:// 获取所有视频列表。

高级用法

在实际开发中，可根据不同的业务需求，灵活调整配置参数，如宽高比、人物生成策略、时长等，以生成满足特定需求的视频。同时，可结合外部服务集成，进一步拓展视频生成的功能。

📚 详细文档

项目结构

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

构建项目

npm run build

开发模式

npm run dev

环境变量

| 属性 | 详情 | |------|------| | PORT | 应用运行端口，默认值为 3000 | | API_KEY | Google API 的密钥，必填项 | | DEBUG | 启用调试模式，默认值为 false | | ASPECT_RATIOS | 支持的宽高比选项，默认值为 ["16:9", "9:16"] |

📄 许可证

本项目采用 MIT 许可证。

mcp-veo2