@lightcone-ai/daemon 0.14.0 → 0.14.1

package/mcp-servers/official/page-understanding/index.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+import {
+  analyzePage,
+  analyzePageFromHtmlFixture,
+  validatePageUnderstanding,
+} from '../../../../src/video/understanding/index.js';
+
+function toText(payload) {
+  return {
+    content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+  };
+}
+
+function toError(message) {
+  return {
+    isError: true,
+    content: [{ type: 'text', text: `Error: ${message}` }],
+  };
+}
+
+const AnalyzePageOptionsSchema = z.object({
+  settleMs: z.number().int().min(500).max(30000).optional(),
+  timeoutMs: z.number().int().min(5000).max(240000).optional(),
+  viewportWidth: z.number().int().min(360).max(2160).optional(),
+  viewportHeight: z.number().int().min(480).max(3840).optional(),
+  minTextBins: z.number().int().min(3).max(40).optional(),
+  minBinChars: z.number().int().min(12).max(200).optional(),
+  allowVisionFallback: z.boolean().optional(),
+  useLlm: z.boolean().optional(),
+  fixture_mode: z.boolean().optional(),
+}).passthrough();
+
+const server = new McpServer({
+  name: 'official-page-understanding',
+  version: '0.1.0',
+});
+
+server.tool(
+  'analyze_page',
+  'Analyze webpage structure for short-video narration planning. Returns page_understanding schema.',
+  {
+    url: z.string().url().describe('Target page URL.'),
+    persona: z.string().optional().describe('Audience persona, e.g. "校招求职学生".'),
+    options: AnalyzePageOptionsSchema.optional(),
+  },
+  async ({ url, persona = '', options = {} }) => {
+    try {
+      let payload;
+      if (options?.fixture_mode) {
+        payload = await analyzePageFromHtmlFixture({
+          url,
+          hostname: new URL(url).hostname,
+          persona,
+          bins: [
+            { y_center: 380, text: '这是一个用于 smoke test 的结构化 bin 内容。' },
+            { y_center: 980, text: '该页面包含若干重点段落，用于验证 schema 输出。' },
+          ],
+          hotspots: [
+            { y: 420, reason: '标题区域', weight: 9, type: 'h1' },
+            { y: 1100, reason: '正文重点', weight: 8, type: 'h2' },
+          ],
+          meta: {
+            title: 'Fixture Page',
+            og_title: 'Fixture Page',
+            og_description: 'Fixture mode output for analyze_page smoke test.',
+          },
+        });
+      } else {
+        payload = await analyzePage({
+          url,
+          persona,
+          options,
+        });
+      }
+
+      const validation = validatePageUnderstanding(payload);
+      if (!validation.ok) {
+        return toError(`page_understanding_validation_failed: ${validation.errors.join('; ')}`);
+      }
+      return toText(payload);
+    } catch (error) {
+      return toError(error?.message ?? 'analyze_page_failed');
+    }
+  }
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error('[page-understanding] MCP Server started');

package/mcp-servers/official/page-understanding/manifest.json

@@ -0,0 +1,20 @@
+{
+  "id": "page-understanding",
+  "name": "Official Page Understanding MCP",
+  "version": "0.1.0",
+  "runtime": "node",
+  "entrypoint": "index.js",
+  "tool_declarations": [
+    { "name": "analyze_page", "classification": "cacheable" }
+  ],
+  "smoke_test": {
+    "tool": "analyze_page",
+    "arguments": {
+      "url": "https://example.com",
+      "persona": "通用用户",
+      "options": {
+        "fixture_mode": true
+      }
+    }
+  }
+}