@okostream/mcp 0.1.0

package/dist/utils.js

@@ -0,0 +1,79 @@
+const DEFAULT_CHARACTER_LIMIT = 30_000;
+const MAX_COMPACT_ARRAY_ITEMS = 25;
+const MAX_COMPACT_OBJECT_KEYS = 60;
+const MAX_COMPACT_STRING_LENGTH = 2_000;
+export function serialize(value) {
+    if (value == null)
+        return value;
+    if (typeof value !== "object")
+        return value;
+    if (typeof value.toDate === "function") {
+        return value.toDate().toISOString();
+    }
+    if (Array.isArray(value))
+        return value.map(serialize);
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+        if (item !== undefined)
+            out[key] = serialize(item);
+    }
+    return out;
+}
+export function docJson(snap) {
+    return { id: snap.id, ...serialize(snap.data()) };
+}
+function compactForText(value, depth = 0) {
+    if (typeof value === "string" && value.length > MAX_COMPACT_STRING_LENGTH) {
+        return `${value.slice(0, MAX_COMPACT_STRING_LENGTH)}... [truncated ${value.length - MAX_COMPACT_STRING_LENGTH} chars]`;
+    }
+    if (value == null || typeof value !== "object")
+        return value;
+    if (Array.isArray(value)) {
+        const items = value.slice(0, MAX_COMPACT_ARRAY_ITEMS).map((item) => compactForText(item, depth + 1));
+        if (value.length > MAX_COMPACT_ARRAY_ITEMS) {
+            items.push({ omittedItems: value.length - MAX_COMPACT_ARRAY_ITEMS });
+        }
+        return items;
+    }
+    if (depth >= 4)
+        return "[nested object omitted]";
+    const entries = Object.entries(value);
+    const out = {};
+    for (const [key, item] of entries.slice(0, MAX_COMPACT_OBJECT_KEYS)) {
+        out[key] = compactForText(item, depth + 1);
+    }
+    if (entries.length > MAX_COMPACT_OBJECT_KEYS) {
+        out.omittedKeys = entries.length - MAX_COMPACT_OBJECT_KEYS;
+    }
+    return out;
+}
+export function textResult(data, options = {}) {
+    const maxChars = options.maxChars ?? DEFAULT_CHARACTER_LIMIT;
+    let structuredContent = serialize(data);
+    let text = JSON.stringify(structuredContent, null, 2);
+    if (text.length > maxChars) {
+        structuredContent = {
+            ...compactForText(structuredContent),
+            truncated: true,
+            truncationMessage: `Response JSON exceeded ${maxChars} characters. ${options.truncationHint ?? "Use limit/cursor or narrower include options."}`,
+        };
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify(structuredContent, null, 2) }],
+        structuredContent,
+    };
+}
+export function requireConfirm(confirm, action, preview) {
+    if (confirm === true)
+        return;
+    throw new Error(`${action} requires confirm:true. Preview: ${JSON.stringify(serialize(preview))}`);
+}
+export function csvCell(value) {
+    let text = value == null ? "" : String(value);
+    if (/^[=+\-@]/.test(text))
+        text = `'${text}`;
+    return `"${text.replace(/"/g, '""')}"`;
+}
+export function safeString(value, fallback = "") {
+    return typeof value === "string" ? value : fallback;
+}

package/dist/videoUrl.js

@@ -0,0 +1,162 @@
+export function extractIframeSrc(input) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith("<iframe"))
+        return null;
+    const match = trimmed.match(/\bsrc=["']([^"']+)["']/i);
+    return match?.[1] ?? null;
+}
+const YT_ID_RE = /^[\w-]{11}$/;
+function extractYouTubeId(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return null;
+    }
+    const host = parsed.hostname.replace(/^www\./, "");
+    if (host === "youtu.be") {
+        const id = parsed.pathname.slice(1).split("/")[0] ?? "";
+        return YT_ID_RE.test(id) ? id : null;
+    }
+    if (host !== "youtube.com" && host !== "m.youtube.com")
+        return null;
+    const path = parsed.pathname;
+    if (path.startsWith("/embed/")) {
+        const id = path.slice(7).split("/")[0] ?? "";
+        return YT_ID_RE.test(id) ? id : null;
+    }
+    if (path.startsWith("/shorts/")) {
+        const id = path.slice(8).split("/")[0] ?? "";
+        return YT_ID_RE.test(id) ? id : null;
+    }
+    if (path.startsWith("/live/")) {
+        const id = path.slice(6).split("/")[0] ?? "";
+        return YT_ID_RE.test(id) ? id : null;
+    }
+    if (path === "/watch") {
+        const id = parsed.searchParams.get("v") ?? "";
+        return YT_ID_RE.test(id) ? id : null;
+    }
+    return null;
+}
+function hostOf(url) {
+    try {
+        return new URL(url).hostname.replace(/^www\./, "").replace(/^m\./, "");
+    }
+    catch {
+        return null;
+    }
+}
+function extractVkVideoIds(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return null;
+    }
+    if (parsed.pathname.includes("video_ext.php")) {
+        const oid = parsed.searchParams.get("oid");
+        const id = parsed.searchParams.get("id");
+        return oid && id ? { oid, id } : null;
+    }
+    const match = parsed.pathname.match(/\/video(-?\d+)_(\d+)/);
+    return match ? { oid: match[1] ?? "", id: match[2] ?? "" } : null;
+}
+function extractPathId(url, host, patterns) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return null;
+    }
+    if (parsed.hostname.replace(/^www\./, "") !== host && !parsed.hostname.endsWith(`.${host}`))
+        return null;
+    for (const pattern of patterns) {
+        const match = parsed.pathname.match(pattern);
+        if (match?.[1])
+            return match[1];
+    }
+    return null;
+}
+function extractTwitchEmbed(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return null;
+    }
+    const host = parsed.hostname.replace(/^www\./, "");
+    if (host === "player.twitch.tv") {
+        const channel = parsed.searchParams.get("channel");
+        const video = parsed.searchParams.get("video");
+        if (channel)
+            return `https://player.twitch.tv/?channel=${channel}&parent=okostream.app`;
+        if (video)
+            return `https://player.twitch.tv/?video=${video}&parent=okostream.app`;
+    }
+    if (host === "twitch.tv") {
+        const vodMatch = parsed.pathname.match(/\/videos\/(\d+)/);
+        if (vodMatch?.[1])
+            return `https://player.twitch.tv/?video=v${vodMatch[1]}&parent=okostream.app`;
+        const channelMatch = parsed.pathname.match(/^\/([a-zA-Z0-9_]+)$/);
+        if (channelMatch?.[1])
+            return `https://player.twitch.tv/?channel=${channelMatch[1]}&parent=okostream.app`;
+    }
+    return null;
+}
+export function detectAndNormalize(url) {
+    const trimmed = url.trim();
+    if (!trimmed)
+        return { provider: "unknown", normalizedUrl: null };
+    const host = hostOf(trimmed);
+    if (host === "youtube.com" || host === "youtu.be") {
+        const id = extractYouTubeId(trimmed);
+        return { provider: "youtube", normalizedUrl: id ? `https://www.youtube.com/embed/${id}` : null };
+    }
+    if (host === "vk.com" || host === "vkvideo.ru") {
+        const ids = extractVkVideoIds(trimmed);
+        return { provider: "vk", normalizedUrl: ids ? `https://vk.com/video_ext.php?oid=${ids.oid}&id=${ids.id}&hd=2` : null };
+    }
+    const rutubeId = extractPathId(trimmed, "rutube.ru", [/\/play\/embed\/([a-f0-9]+)/i, /\/video\/([a-f0-9]+)/i]);
+    if (rutubeId)
+        return { provider: "rutube", normalizedUrl: `https://rutube.ru/play/embed/${rutubeId}` };
+    if (trimmed.includes("rutube.ru"))
+        return { provider: "rutube", normalizedUrl: null };
+    const vimeoId = extractPathId(trimmed, "vimeo.com", [/\/video\/(\d+)/, /^\/(\d+)/]);
+    if (vimeoId)
+        return { provider: "vimeo", normalizedUrl: `https://player.vimeo.com/video/${vimeoId}` };
+    if (trimmed.includes("vimeo.com"))
+        return { provider: "vimeo", normalizedUrl: null };
+    const kinescopeId = extractPathId(trimmed, "kinescope.io", [/\/embed\/([a-zA-Z0-9]+)/, /^\/([a-zA-Z0-9]+)$/]);
+    if (kinescopeId)
+        return { provider: "kinescope", normalizedUrl: `https://kinescope.io/embed/${kinescopeId}` };
+    if (trimmed.includes("kinescope.io"))
+        return { provider: "kinescope", normalizedUrl: null };
+    const dzenId = extractPathId(trimmed, "dzen.ru", [/\/embed\/([a-zA-Z0-9_-]+)/, /\/video\/watch\/([a-zA-Z0-9_-]+)/]);
+    if (dzenId)
+        return { provider: "dzen", normalizedUrl: `https://dzen.ru/embed/${dzenId}` };
+    if (trimmed.includes("dzen.ru"))
+        return { provider: "dzen", normalizedUrl: null };
+    const twitchEmbed = extractTwitchEmbed(trimmed);
+    if (twitchEmbed)
+        return { provider: "twitch", normalizedUrl: twitchEmbed };
+    if (trimmed.includes("twitch.tv"))
+        return { provider: "twitch", normalizedUrl: null };
+    const dailymotionId = extractPathId(trimmed, "dailymotion.com", [/\/embed\/video\/([a-zA-Z0-9]+)/, /\/video\/([a-zA-Z0-9]+)/])
+        ?? extractPathId(trimmed, "dai.ly", [/^\/([a-zA-Z0-9]+)/]);
+    if (dailymotionId)
+        return { provider: "dailymotion", normalizedUrl: `https://www.dailymotion.com/embed/video/${dailymotionId}` };
+    if (trimmed.includes("dailymotion.com") || trimmed.includes("dai.ly"))
+        return { provider: "dailymotion", normalizedUrl: null };
+    const wistiaId = extractPathId(trimmed, "wistia.com", [/\/medias\/([a-zA-Z0-9]+)/])
+        ?? extractPathId(trimmed, "fast.wistia.net", [/\/embed\/iframe\/([a-zA-Z0-9]+)/]);
+    if (wistiaId)
+        return { provider: "wistia", normalizedUrl: `https://fast.wistia.net/embed/iframe/${wistiaId}` };
+    if (trimmed.includes("wistia.com") || trimmed.includes("wistia.net"))
+        return { provider: "wistia", normalizedUrl: null };
+    return { provider: "unknown", normalizedUrl: null };
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@okostream/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for managing OKO Stream webinars as an organizer.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "dist/server.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BelfanioXL/okostreamcore.git",
+    "directory": "mcp"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "oko-mcp": "dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/server.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "dotenv": "^17.2.3",
+    "firebase": "^12.10.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.37",
+    "typescript": "^5.9.3"
+  }
+}