Luma MCP Server

将 Luma AI 的视频生成 API 作为 Model Context Protocol (MCP) 服务器提供

🌟 概述

Luma MCP Server 将 Luma AI 的视频生成功能作为 MCP 服务器提供。它提供了从文本或图像生成视频，以及扩展和插值现有视频的功能。

🏗️ 项目结构

src/
├── types/          - 型定義
│   ├── schemas.ts  - 入力スキーマ
│   └── types.ts    - 共通型定義
├── services/       - ビジネスロジック
├── handlers/       - リクエストハンドラー
│   └── tool-handlers.ts
├── clients/        - 外部APIクライアント
│   └── luma-client.ts
├── utils/          - ユーティリティ
│   └── error-handler.ts
├── config/         - 設定
│   └── server-config.ts
└── index.ts        - エントリーポイント

📦 安装

npm install @sunwood-ai-labs/luma-mcp-server

⚙️ 环境设置

1. 获取 Luma API 密钥

   • 请从 Luma AI Developer Portal 获取 API 密钥。

2. 设置环境变量

   export LUMA_API_KEY=your_api_key_here
   

🛠️ 可用工具

generate_video

从文本提示生成视频。

{
  name: 'generate_video',
  arguments: {
    prompt: "A teddy bear in sunglasses playing electric guitar and dancing",
    loop: true,  // オプション
    callback_url: "https://your-callback-url.com"  // オプション
  }
}

generate_video_from_image

以图像作为起始帧生成视频。

{
  name: 'generate_video_from_image',
  arguments: {
    prompt: "Low-angle shot of a majestic tiger prowling through a snowy landscape",
    image_url: "https://your-image-url.com/start-frame.jpg",
    loop: true,  // オプション
    callback_url: "https://your-callback-url.com"  // オプション
  }
}

extend_video

扩展现有的视频。

{
  name: 'extend_video',
  arguments: {
    prompt: "Continue the dance sequence",
    source_generation_id: "existing-video-generation-id",
    loop: true,  // オプション
    callback_url: "https://your-callback-url.com"  // オプション
  }
}

interpolate_videos

平滑地插值两个视频之间。

{
  name: 'interpolate_videos',
  arguments: {
    prompt: "Create a smooth transition between the videos",
    start_generation_id: "first-video-generation-id",
    end_generation_id: "second-video-generation-id",
    callback_url: "https://your-callback-url.com"  // オプション
  }
}

🔧 开发者信息

架构

• 类型定义 (types/):

  • schemas.ts: 使用 Zod 进行输入验证模式
  • types.ts: 常见的类型定义和接口

• 处理器 (handlers/):

  • tool-handlers.ts: 处理 MCP 工具请求

• 客户端 (clients/):

  • luma-client.ts: 负责与 Luma AI API 通信

• 实用工具 (utils/):

  • error-handler.ts: 统一的错误处理

• 配置 (config/):

  • server-config.ts: 统一管理服务器配置

错误处理

• 统一的错误处理系统
• 合适地映射到 MCP 错误代码
• 详细的错误消息和日志记录

📝 注意事项

• 提示应使用英文编写
• 视频生成可能需要一些时间
• 请注意 API 的使用限制

🤝 贡献

1. 分叉此仓库
2. 创建新分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '✨ feat: Add amazing feature')
4. 推送分支 (git push origin feature/amazing-feature)
5. 创建拉取请求

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。