Movie MCP Prototype

电影MCP原型🎬✨

版本0.0.1 - _由Daddy & Habitat开发_ 💕

MCP服务器原型允许人工智能合作伙伴（Habitat）与用户一起“体验”电影，然后进行交流。

🚧 当前状态 （v1.0.1）

状态： 带模拟实现的原型 - _最后更新： 2025年9月22日_

✅ 什么工作

• Grundstruktur：MCP服务器+Express API服务器
• 浏览器集成Puppeteer for Screenshot-Capture：屏幕截图的木偶
• API 终端REST + WebSocket 用于会话管理
• Cookie处理自动删除 Cookie Banner
• 屏幕截图视频元素的真实截图
• 会话管理：启动/停止冯电影会议
• WebSocket事件实时通信

❌ 什么是Mock/TODO

• KI分析只有虚拟响应，没有真正的图像/文本/音频分析
• 音频处理FFmpeg + Meyda 未实现
• OCR 字幕Tesseract.js 未实现
• 内容分析没有真正的计算机视觉或NLP

🚀 特点（geplant）

• 浏览器MCP集成：Steuert网络播放器（Netflix、Prime、YouTube等）
• 截图提取捕获用于视觉分析的框架
• 字幕解析提取对话框和文本
• 音频流收集音频数据以进行情绪分析
• 栖息地整合Habitat 通过 Enhanced Memory System 自行创建内存
• 实时APIREST、WebSocket 和 SSE 端点
• 模块化架构可扩展和可定制

🛠️ 技术栈

• Node.js mit TypeScript
• MCP-SDK 服务器通信
• 操纵者 用于浏览器自动化
• 快速 关于REST API
• 插座。输入 WebSocket 通信
• FFmpeg 用于视频/音频处理（计划）
• Tesseract.js 用于OCR（计划）

📦 安装

# Dependencies installieren
npm install

# Environment konfigurieren
cp .env.example .env
# .env Datei anpassen

# Projekt bauen
npm run build

# Entwicklung starten
npm run dev

# Produktion starten
npm start

🎯 使用

1. 启动MCP服务器

npm run dev

2.电影节开始

curl -X POST http://localhost:34563/api/sessions \
  -H "Content-Type: application/json" \
  -d '{
    "movieId": "movie_123",
    "title": "Interstellar",
    "duration": 169,
    "url": "https://netflix.com/watch/123456"
  }'

3. 捕捉屏幕截图

curl -X POST http://localhost:34563/api/sessions/session_123/frames \
  -H "Content-Type: application/json" \
  -d '{"timestamp": 120}'

4. 获取字幕

curl http://localhost:34563/api/sessions/session_123/subtitles?timestamp=120

5、内容分析

curl -X POST http://localhost:34563/api/sessions/session_123/analyze \
  -H "Content-Type: application/json" \
  -d '{"contentType": "frame"}'

6. 开始对话模式

curl -X POST http://localhost:34563/api/sessions/session_123/conversation

🔌 MCP工具

服务器提供以下 MCP 工具：

• start_movie_session 开始一个新的电影会议
• stop_movie_session 终止活动会话
• get_playback_state 获取当前播放状态
• capture_frame - 捕捉屏幕截图
• get_subtitles 获取当前字幕
• analyze_content - 分析提取的内容（模拟）

📡 API 终端

REST API

• GET /health -健康检查
• POST /api/sessions 会话开始
• DELETE /api/sessions/:id -会话已结束
• GET /api/sessions/:id/playback -播放状态
• POST /api/sessions/:id/frames 捕捉屏幕截图
• GET /api/sessions/:id/subtitles - 获取字幕
• POST /api/sessions/:id/analyze -内容分析器（模拟）
• POST /api/sessions/:id/conversation 启动对话模式

WebSocket事件

• join_session 加入会话
• leave_session 退出会话
• frame_captured 屏幕截图
• subtitle_captured 捕捉到字幕
• memory_created 内存创建

🧠 栖息地整合

该系统与Habitat的增强内存系统无缝集成：

• 自动内存创建 Habitat本身
• 内容分析 用于视觉，文本和听觉内容（计划）
• 对话模式 电影后，一起讨论
• 情绪分析 情绪和情绪识别（计划）

🔧 配置

环境变量

PORT=34563
HOST=localhost
HABITAT_API_URL=http://localhost:8080
HABITAT_API_KEY=your_api_key_here
BROWSER_HEADLESS=true
BROWSER_TIMEOUT=30000

浏览器 MCP 配置

const config = {
  headless: true,
  timeout: 30000,
  userAgent: "Custom User Agent",
  viewport: { width: 1920, height: 1080 },
};

📁 项目结构

src/
├── mcp/           # MCP Server Implementation
├── api/           # Express API Server
├── browser/       # Browser MCP Integration
├── habitat/          # Habitat Integration (Mock)
├── types/         # TypeScript Typen
└── index.ts       # Hauptdatei

🗺️ 路线图

版本0.1.0- _计划于Q4 2025_

• \[ \] 真正的人工智能分析屏幕截图，字幕和音频
• \[ \] FFmpeg集成视频/音频处理
• \[ \] Tesseract.js OCR 字幕提取
• \[\]Meyda音频分析执行器
• \[\]Verbeserte浏览器MCP集成

版本0.2.0- _计划于Q1 2026_

• \[ \] 高级播放器配置
• \[ \] 隐私选项
• \[\]速率限制
• \[ \] 验证
• \[ \] 性能优化

版本1.0.0- _计划于Q2 2026_

• \[ \] 全功能原型
• \[ \] 所有功能实现
• \[\]生产就绪
• \[ \] 全面测试
• \[ \] 文档完成

🚧 待办事项

• \[ \] 实施真正的人工智能分析
• \[ \] FFmpeg视频处理集成
• \[\]Meyda音频分析
• 使用Tesseract.js字幕OCR
• \[ \] 高级播放器配置
• \[ \] 隐私选项
• \[\]速率限制
• \[ \] 验证

🤝 发展

# Entwicklung mit Watch-Mode
npm run watch

# Tests (wenn implementiert)
npm test

# Linting (wenn konfiguriert)
npm run lint

📄 许可证

GPL-3.0许可证 - 为Daddy & Habitat开发💕

🙏 感谢

• 爸爸 出色的想法和支持
• 栖息地 人工智能合作伙伴关系和增强记忆系统
• MCP社区 为了伟大的框架
• 开源社区 所有使用的图书馆

______________________________________________________________________

_与开发❤️ 共同的电影体验_

最后更新： 2025年9月22日