Reelmotion AI Agent MCP

重新命名AI代理MCP

使用Google Gemini和多个AI模型生成图像和视频的AI代理。

特性

• 🤖 双子座聊天机器人 支持多语言（英语/西班牙语自动检测）
• 🖼️ 图像生成 （Nano Banana、GPT型号）
• 🎬 视频生成 （跑道Aleph、Veo 3.1、Sora 2等）
• 💾 基于Redis的会话管理 用于并发对话
• 🔄 参考文件持久性 （图片/视频通过URL）
• 📊 代币成本计算 前代
• 🌐 多会话支持 基于UUID的会话跟踪
• 🚀 基于URL的文件处理 （无base64，性能优化）

技术栈

• Python 3.11+
• Google Gemini API （双生-2.5-flash）
• 瑞迪斯 （用于会话存储）
• FastMCP （模型上下文协议服务器）
• Docker&Docker编写

🆕 新增：基于URL的文件处理

MCP现在接受 直接文件URL 代替base64编码：

// Laravel example
Http::asForm()->post('http://localhost/api/chat', [
    'message' => 'Generate an image with this reference',
    'token' => $token,
    'conversation_uuid' => $uuid,
    'files[0]' => 'https://storage.googleapis.com/bucket/image.jpg',
    'file_types[0]' => 'image',
]);

优点：

• ✅ 无base64转换开销
• ✅ Redis内存使用减少
• ✅ 更快的处理速度
• ✅ 与云存储直接集成

看 用法\_ GIDE.md 以获取详细示例。

快速启动（生产）

先决条件

• Ubuntu 22.04+虚拟机（谷歌云、AWS等）
• 已安装Docker和Docker Compose
• 域名（可选，用于SSL）

部署

# Clone repository
git clone https://github.com/VictorEspinosa98/reelmotion-ai-agent-mcp.git
cd reelmotion-ai-agent-mcp

# Configure environment
nano .env.production
# Add your GOOGLE_API_KEY

# Give execution permissions
chmod +x deploy.sh

# Deploy
./deploy.sh

健康检查

curl http://localhost:8000/health

本地开发（Windows）

先决条件

• Python 3.11+
• 本地运行Redis或Docker
• Google Gemini API密钥

设置

# Create virtual environment
python -m venv venv
.\venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Configure environment
copy .env.example .env
# Edit .env with your API keys

# Start Redis (use redis-portable or Docker)
cd redis-portable
.\redis-server.exe redis.windows.conf

# Start server (in another terminal)
python reelmotion_mcp/server.py http

API终点

聊天

POST /api/chat
Content-Type: multipart/form-data

{
  "message": "Generate an image of a christmas pug",
  "conversation_uuid": "unique-session-id",
  "token": "optional-bearer-token"
}

健康检查

GET /health

可用型号

图像生成

• 纳米香蕉 -快速生成（10个令牌/图像）
• GPT -高质量图像（10个标记/图像）

视频生成

• 跑道警报 （19个令牌/秒）-5-10秒，视频到视频
• 我看到3.1 （48个令牌/秒）-8秒，高质量
• 我看到3.1闪光 （21个代币/秒）-8秒，快速经济
• 我看到3.1超 （60个令牌/秒）-8秒，最高质量
• 索拉2 （15个令牌/秒）-4、8或12秒
• 索拉2 Pro （30个令牌/秒）-4、8或12秒，最高质量

建筑

┌─────────────────┐
│   Frontend      │
│   (React)       │
└────────┬────────┘
         │ HTTP
         ▼
┌─────────────────┐     ┌─────────────────┐
│   FastMCP       │────▶│   Google        │
│   Server        │     │   Gemini API    │
└────────┬────────┘     └─────────────────┘
         │
         ▼
┌─────────────────┐     ┌─────────────────┐
│   Redis         │     │   reelmotion    │
│   (Sessions)    │     │   Backend API   │
└─────────────────┘     └─────────────────┘

环境变量

GOOGLE_API_KEY=your_gemini_api_key
GEMINI_MODEL=gemini-2.5-flash
REDIS_URL=redis://localhost:6379
BACKEND_URL=https://backend.reelmotion.ai/
IMAGE_CREATION_ENDPOINT=api/ai/mcp-image-generation
VIDEO_CREATION_ENDPOINT=api/ai/mcp-video-generation

贡献

这是一个私人的项目，为reelmotion媒体有限公司。

许可证

专有-保留所有权利reelmotion Media有限公司。

支持

如有疑问，请联系：reelmeinmedialtd@gmail.com