Skip to main content
Glama
2bai4me

ME4-YOUTUBE

by 2bai4me
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

ME4-YouTube

🧠 Standards: Dieses Projekt folgt den ME4-Service-Bus-Standards v1.0.
📖 Verbindlich: HUB-Thought im openBrain — die Single source of truth.
⚠️ Abweichungen MÜSSEN in einem PR begründet werden.

ME4-Standard openBrain SOA-konform

Service-ID: ME4-YOUTUBE
Version: 1.0.0
Schnittstellen: MCP (stdio + ZMQ REQ/REP) + HTTP/REST + WSSP-15 + Framie-UI

YouTube Content Extraction Service für die ME4-Suite:

  • Download — Video- und Audio-Download via yt-dlp

  • Beschreibung — Vollständige Metadaten inkl. Description

  • Transkript — Manuell oder Auto-Generated, Multi-Language

  • Kommentare — Top-Kommentare via yt-dlp

  • Loadbalancer-MCP — Parallele Worker-Instanzen mit Health-Monitoring

  • Framie-UI — Embedded Live-Status-Display

Schnellstart

# Voraussetzungen: Python 3.11+, ffmpeg (optional, für Audio-Konvertierung)

# Klonen / Installieren
cd D:\Entwicklung\ME4-YouTube
python -m venv .venv
.venv\Scripts\activate           # Windows
# source .venv/bin/activate      # macOS/Linux
pip install -r requirements.txt

# Konfiguration (Beispiel kopieren, anpassen)
copy .env.example .env           # Windows
# cp .env.example .env           # macOS/Linux

# Starten
python main.py

# ODER (öffnet Framie-UI nicht automatisch)
python main.py --no-browser

Beim Start öffnet sich automatisch die Framie-UI im Browser unter http://localhost:8770/ui/index.html.

Related MCP server: youtube-mcp

Schnittstellen

Schnittstelle

Port

Zweck

HTTP / REST

8770

Browser, Menschen, externe Tools

ZMQ Main

5570

MCP-Service-Endpoint

ZMQ Loadbalancer

5571

MCP-Loadbalancer (parallele Worker)

WSSP-15

5690

Heartbeat / Telemetrie

Worker-Pool

8771+

N parallele Worker-Instanzen (default: 2)

MCP-Tools (ZMQ + stdio)

Tool

Beschreibung

Auth

ping

Service-Health

public

get_manifest

UI-Manifest für Cockpit

public

health

Detaillierter Status inkl. Worker-Pool

public

get_status_snapshot

Live-Job-Status

public

get_metadata

YouTube Metadaten + Description

🔑

get_transcript

YouTube Transkript

🔑

get_comments

YouTube Top-Kommentare

🔑

download

Video/Audio herunterladen

🔑

process

Komplette Pipeline (alle 4 Features)

🔑

trigger_sm_produce

SM-Producer anstoßen

🔑

shutdown

Geordneter Shutdown

🔑

HTTP-Endpunkte

Pfad

Methode

Beschreibung

/

GET

Service-Info

/docs

GET

OpenAPI/Swagger UI

/api/health

GET

Health (public)

/api/manifest

GET

UI-Manifest (public)

/api/status

GET

Live-Job-Status (public)

/api/framie/stream

GET

SSE-Stream für Framie-UI (public)

/api/process

POST

Komplette Verarbeitung (🔑)

/api/metadata

POST

Nur Metadaten (🔑)

/api/transcript

POST

Nur Transkript (🔑)

/api/comments

POST

Nur Kommentare (🔑)

/api/download

POST

Video-Download (🔑)

/api/sm-produce

POST

SM-Producer triggern (🔑)

/ui/index.html

GET

Framie Live-Status-Display

🔑 = X-API-Key Header erforderlich (oder Dev-Mode wenn API_KEY="")

Beispiele

HTTP (curl)

# Metadaten + Beschreibung
curl -X POST http://localhost:8770/api/metadata \
  -H "X-API-Key: ob-youtube-key-2026" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://youtu.be/dQw4w9WgXcQ"}'

# Komplette Verarbeitung (alle Features)
curl -X POST http://localhost:8770/api/process \
  -H "X-API-Key: ob-youtube-key-2026" \
  -H "Content-Type: application/json" \
  -d '{
    "url":"https://youtu.be/dQw4w9WgXcQ",
    "download":false,
    "include_description":true,
    "include_transcript":true,
    "include_comments":true,
    "language":"de",
    "max_comments":100
  }'

ZMQ (Python)

import zmq, json

ctx = zmq.Context()
sock = ctx.socket(zmq.REQ)
sock.connect("tcp://127.0.0.1:5570")

sock.send_json({
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
        "name": "process",
        "arguments": {
            "url": "https://youtu.be/dQw4w9WgXcQ",
            "api_key": "ob-youtube-key-2026",
        }
    }
})
print(sock.recv_json())

MCP stdio (Claude Code / Agenten)

{
  "mcpServers": {
    "me4-youtube": {
      "command": "python",
      "args": ["D:/Entwicklung/ME4-YouTube/main.py", "--mcp-stdio"]
    }
  }
}

Loadbalancer-MCP (parallele Verarbeitung)

Der Service bringt einen eingebauten Loadbalancer-MCP mit. Agenten können Jobs direkt an den Loadbalancer schicken, der sie auf freie Worker verteilt:

sock.connect("tcp://127.0.0.1:5571")
sock.send_json({
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
        "name": "process",
        "arguments": {
            "url": "https://youtu.be/dQw4w9WgXcQ",
            "api_key": "ob-youtube-key-2026",
        }
    }
})

Strategien: round_robin, least_loaded, random (default: least_loaded)

SM-Producer Anbindung

Der Service kann direkt die SM-Producer-Pipeline (ME4-SMproducer-3) anstoßen:

curl -X POST http://localhost:8770/api/sm-produce \
  -H "X-API-Key: ob-youtube-key-2026" \
  -H "Content-Type: application/json" \
  -d '{
    "url":"https://youtu.be/dQw4w9WgXcQ",
    "transcript":"Volltext...",
    "language":"de",
    "workflow":"default"
  }'

Der Aufruf wird an http://localhost:3001/api/sm-produce weitergeleitet. Konfiguration via SM_PRODUCER_URL und SM_PRODUCER_API_KEY in .env.

Framie-UI

Beim Start des Services öffnet sich automatisch die Framie-UI im Browser:

  • KPIs: aktive Jobs, erledigt, Fehler, Worker-Status

  • Live-Stream über Server-Sent Events

  • Worker-Liste mit Idle/Busy/Down-Status

  • Letzte 15 Jobs in Tabelle

  • Event-Log

URL: http://localhost:8770/ui/index.html

Tests

pip install pytest pytest-asyncio
pytest

# Mit Coverage
pip install pytest-cov
pytest --cov=app --cov-report=term-missing

Konfiguration (.env)

Siehe .env.example für alle Optionen.

Wichtige Variablen:

  • API_KEY — API-Key (leer = Dev-Mode)

  • WORKER_COUNT — Anzahl paralleler Worker (default: 2)

  • LOADBALANCER_STRATEGY — round_robin | least_loaded | random

  • SM_PRODUCER_URL — SM-Producer-Pipeline-URL

  • DOWNLOAD_DIR — Zielordner für Downloads

Schnittstellen-Standard

Konform zu MCP_ZMQ_STANDARD.md:

  • ZMQ REQ/REP mit JSON-RPC 2.0

  • WSSP-15 Heartbeat

  • API-Key Auth

  • UI-Manifest

  • Standard-Tools (ping, get_manifest, health, shutdown)

Architektur

┌──────────────────────────────────────────────────────────┐
│ ME4-YouTube (Service-ID: ME4-YOUTUBE)                    │
│                                                          │
│  ┌────────────────┐  ┌─────────────────┐                │
│  │  HTTP API      │  │  ZMQ Main       │                │
│  │  :8770         │  │  :5570          │                │
│  │  + Framie-UI   │  │  MCP REQ/REP    │                │
│  └────────┬───────┘  └────────┬────────┘                │
│           │                   │                         │
│           └─────────┬─────────┘                         │
│                     ▼                                   │
│           ┌─────────────────────┐                       │
│           │  WorkerPool         │                       │
│           │  (Load-Balancer)    │                       │
│           │  ZMQ :5571          │◄──── Loadbalancer-MCP  │
│           └─────────┬───────────┘                       │
│                     │                                   │
│         ┌───────────┼───────────┐                       │
│         ▼           ▼           ▼                       │
│    ┌─────────┐ ┌─────────┐ ┌─────────┐                  │
│    │worker-01│ │worker-02│ │worker-03│  (jeweils        │
│    │  :8771  │ │  :8772  │ │  :8773  │   Orchestrator)  │
│    └─────────┘ └─────────┘ └─────────┘                  │
│                                                          │
│  ┌────────────────┐  ┌─────────────────┐                │
│  │ WSSP-15 :5690  │  │  SM-Producer    │                │
│  │  Heartbeat     │  │  HTTP :3001     │                │
│  └────────────────┘  └─────────────────┘                │
└──────────────────────────────────────────────────────────┘

Jeder Worker hat:

  • eigenen HTTP-Server (für eingehende Jobs vom Loadbalancer)

  • einen Orchestrator (führt die Pipeline aus)

  • Status-Updates landen im globalen StatusTracker → Framie-Stream

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/2bai4me/ME4-Service-YouTube'

If you have feedback or need assistance with the MCP directory API, please join our Discord server