@houtini/gemini-mcp 1.2.2 → 1.3.0

package/README.md

@@ -583,6 +583,160 @@ Use Gemini deep research with 3 iterations focusing on cost analysis and market
 
 **Note**: Deep research takes several minutes as it performs multiple iterations. Perfect for when you need comprehensive, well-researched analysis rather than quick answers.
 
+## Video Description for Accessibility
+
+The server includes a specialized **video description tool** designed to generate detailed audio descriptions of YouTube video content for accessibility purposes. This tool analyzes visual content including actions, spatial relationships, text overlays, and provides time-stamped descriptions suitable for screen reader users.
+
+### How Video Description Works
+
+The tool uses Gemini's multimodal understanding capabilities to:
+
+1. **Analyze Visual Content** - Processes the video frame by frame to understand what's happening
+2. **Describe Actions** - Details all movements, gestures, and procedures shown
+3. **Spatial Awareness** - Describes positions, movements, and relationships between elements
+4. **Text Recognition** - Transcribes all on-screen text, captions, and overlays verbatim
+5. **Structured Output** - Organizes information in screen reader-friendly formats
+
+### Using Video Description
+
+**Basic Usage:**
+```
+Describe this YouTube video for accessibility: https://www.youtube.com/watch?v=abc123
+```
+
+**With Specific Detail Level:**
+```
+Generate a comprehensive accessibility description for this video: https://www.youtube.com/watch?v=abc123
+```
+
+**Focus on Specific Aspects:**
+```
+Describe the actions shown in this instructional video: https://www.youtube.com/watch?v=abc123
+```
+
+### Description Parameters
+
+| Parameter | Options | Default | Description |
+|-----------|---------|---------|-------------|
+| `detail_level` | `brief`, `standard`, `comprehensive` | `standard` | Controls description depth |
+| `accessibility_mode` | `true`, `false` | `true` | Includes spatial, color, and text details |
+| `include_timestamps` | `true`, `false` | `true` | Adds timestamps to descriptions |
+| `output_format` | `narrative`, `structured` | `structured` | Output as prose or JSON |
+| `focus` | `actions`, `visual_elements`, `text_on_screen`, `all` | `all` | What to emphasize |
+
+### Detail Levels Explained
+
+**Brief** (2-3 paragraphs)
+- High-level summary of video content
+- Main actions and key points only
+- Perfect for quick overview
+
+**Standard** (5-8 scenes)
+- Balanced description with key scenes
+- Major actions and visual elements
+- Recommended for most use cases
+
+**Comprehensive** (10-15+ scenes)
+- Extensive detail for every significant moment
+- Complete coverage of all visual information
+- Best for instructional or technical content
+
+### Accessibility Mode Features
+
+When enabled (default), includes:
+
+- **Spatial Descriptions**: "on the left side of frame", "moving from right to left"
+- **Color Information**: "red laser line", "blue indicator light"
+- **Text Transcription**: All on-screen text verbatim
+- **Facial Expressions**: When relevant to understanding
+- **Sound Cues**: Visible audio indicators
+- **Concrete Language**: Avoids vague references like "this" or "here"
+
+### Output Formats
+
+**Structured JSON** (default):
+```json
+{
+  "video_title": "How to Install Picture Mounts",
+  "duration": "4:32",
+  "scene_count": 8,
+  "scenes": [
+    {
+      "timestamp": "0:00-0:45",
+      "description": "Close-up of hands positioning metal cleat on frame back",
+      "actions": ["Marking screw holes", "Using pencil"],
+      "tools_visible": ["Metal cleat", "Pencil"],
+      "text_on_screen": null,
+      "spatial_notes": "Cleat positioned horizontally on upper portion of frame",
+      "colors": "Silver metal cleat against dark wood frame"
+    }
+  ],
+  "key_techniques": ["Using laser level", "Locating wall studs"],
+  "tools_list": ["Drill", "Laser level", "Stud finder"],
+  "summary": "Demonstrates professional picture hanging using interlocking cleats"
+}
+```
+
+**Narrative Prose**:
+```
+[0:00] The video opens with a close-up view of hands positioning a silver metal 
+cleat horizontally on the back of a dark wooden picture frame...
+```
+
+### Perfect For
+
+**Accessibility Needs**:
+- Screen reader users
+- Visually impaired individuals
+- Audio description requirements
+- WCAG compliance
+
+**Content Analysis**:
+- Tutorial documentation
+- Training material transcription
+- Video content indexing
+- Instructional content breakdown
+
+**Research & Education**:
+- Video content study
+- Procedural analysis
+- Teaching material preparation
+
+### Best Practices
+
+1. **Choose appropriate detail level** - Brief for overviews, comprehensive for tutorials
+2. **Enable accessibility mode** - Always on for screen reader users
+3. **Use structured format** - Better for navigation with assistive technology
+4. **Include timestamps** - Essential for sync with video playback
+5. **Focus parameter** - Use when specific aspects are most important
+
+### Technical Requirements
+
+- **Supported Platforms**: YouTube videos only
+- **Model Used**: Gemini 2.5 Flash (optimized for video understanding)
+- **Response Time**: 30-60 seconds depending on detail level
+- **Token Usage**: 8,000-16,000 tokens for comprehensive descriptions
+
+### Example Use Cases
+
+**Tutorial Documentation**:
+```
+Generate a comprehensive accessibility description focusing on actions for this DIY tutorial: 
+https://www.youtube.com/watch?v=example
+```
+
+**Content Indexing**:
+```
+Create a brief structured description of this product demo: 
+https://www.youtube.com/watch?v=example
+```
+
+**Training Materials**:
+```
+Describe the visual elements and text shown in this training video: 
+https://www.youtube.com/watch?v=example
+```
+
 ## API Reference
 
 ### Available Tools
@@ -653,6 +807,58 @@ Conduct iterative multi-step research on complex topics.
 }
 ```
 
+#### `gemini_describe_video`
+
+Generate detailed audio descriptions of YouTube video content for accessibility.
+
+**Parameters:**
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `url` | string | Yes | - | YouTube URL to analyze |
+| `detail_level` | string | No | `standard` | Level of detail: `brief`, `standard`, `comprehensive` |
+| `accessibility_mode` | boolean | No | `true` | Include spatial descriptions, colors, text overlays |
+| `include_timestamps` | boolean | No | `true` | Add timestamps for all major actions |
+| `output_format` | string | No | `structured` | Format: `narrative` (prose) or `structured` (JSON) |
+| `focus` | string | No | `all` | Focus: `actions`, `visual_elements`, `text_on_screen`, `all` |
+
+**Example:**
+```json
+{
+  "url": "https://www.youtube.com/watch?v=abc123",
+  "detail_level": "comprehensive",
+  "accessibility_mode": true,
+  "include_timestamps": true,
+  "output_format": "structured",
+  "focus": "all"
+}
+```
+
+**Response Format (Structured)**:
+```json
+{
+  "video_title": "How to Install Picture Mounts",
+  "duration": "4:32",
+  "scene_count": 8,
+  "scenes": [
+    {
+      "timestamp": "0:00-0:45",
+      "description": "Detailed scene description",
+      "actions": ["action1", "action2"],
+      "tools_visible": ["tool1", "tool2"],
+      "text_on_screen": "Exact text or null",
+      "spatial_notes": "Spatial relationships",
+      "colors": "Color descriptions"
+    }
+  ],
+  "key_techniques": ["technique1", "technique2"],
+  "tools_list": ["all tools shown"],
+  "materials_list": ["all materials"],
+  "safety_notes": ["safety considerations"],
+  "summary": "Overall summary"
+}
+```
+
 ### Available Models
 
 Models are **dynamically discovered** from Google's API. The exact list may vary, but typically includes:
@@ -883,6 +1089,19 @@ By using this software, you acknowledge that you have read this disclaimer and a
 
 ## Changelog
 
+### v1.3.0
+
+**Accessibility Features**
+- Added `gemini_describe_video` tool for YouTube video accessibility descriptions
+- Comprehensive audio description generation with spatial awareness and text recognition
+- Screen reader-friendly structured JSON output format
+- Configurable detail levels (brief, standard, comprehensive)
+- Time-stamped scene descriptions for video synchronization
+- Focus parameters for emphasizing specific content aspects (actions, visual elements, text)
+- Accessibility mode with spatial descriptions, colors, and text overlays
+- Support for narrative prose and structured JSON output formats
+- Optimized for Gemini 2.5 Flash's multimodal video understanding
+
 ### v1.0.4
 
 **Security and Dependency Updates**

package/dist/config/index.js

@@ -58,7 +58,7 @@ exports.config = {
                 threshold: 'BLOCK_MEDIUM_AND_ABOVE'
             }
         ],
-        defaultModel: 'gemini-2.5-flash',
+        defaultModel: 'gemini-2.5-flash-lite-preview-09-2025',
         maxTokens: 16384,
         temperature: 0.7,
         defaultGrounding: true,

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,wCAOC;AAhDD,+CAAiC;AAEjC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEH,QAAA,MAAM,GAAW;IAC5B,MAAM,EAAE;QACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QAClC,cAAc,EAAE;YACd;gBACE,QAAQ,EAAE,0BAA0B;gBACpC,SAAS,EAAE,wBAAwB;aACpC;YACD;gBACE,QAAQ,EAAE,2BAA2B;gBACrC,SAAS,EAAE,wBAAwB;aACpC;YACD;gBACE,QAAQ,EAAE,iCAAiC;gBAC3C,SAAS,EAAE,wBAAwB;aACpC;YACD;gBACE,QAAQ,EAAE,iCAAiC;gBAC3C,SAAS,EAAE,wBAAwB;aACpC;SACF;QACD,YAAY,EAAE,kBAAkB;QAChC,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,GAAG;QAChB,gBAAgB,EAAE,IAAI;QACtB,uBAAuB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM;KAC1E;IACD,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,MAAM,EAAE,UAAU;KACnB;CACF,CAAC;AAEF,SAAgB,cAAc;IAC5B,IAAI,CAAC,cAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,+CAA+C;YAC/C,yEAAyE,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,wCAOC;AAhDD,+CAAiC;AAEjC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEH,QAAA,MAAM,GAAW;IAC5B,MAAM,EAAE;QACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QAClC,cAAc,EAAE;YACd;gBACE,QAAQ,EAAE,0BAA0B;gBACpC,SAAS,EAAE,wBAAwB;aACpC;YACD;gBACE,QAAQ,EAAE,2BAA2B;gBACrC,SAAS,EAAE,wBAAwB;aACpC;YACD;gBACE,QAAQ,EAAE,iCAAiC;gBAC3C,SAAS,EAAE,wBAAwB;aACpC;YACD;gBACE,QAAQ,EAAE,iCAAiC;gBAC3C,SAAS,EAAE,wBAAwB;aACpC;SACF;QACD,YAAY,EAAE,uCAAuC;QACrD,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,GAAG;QAChB,gBAAgB,EAAE,IAAI;QACtB,uBAAuB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM;KAC1E;IACD,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,MAAM,EAAE,UAAU;KACnB;CACF,CAAC;AAEF,SAAgB,cAAc;IAC5B,IAAI,CAAC,cAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,+CAA+C;YAC/C,yEAAyE,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAiBA,cAAM,eAAe;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,KAAK,CAAmB;;IAkChC,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,aAAa;IAoDf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAsB7B;AAkCD,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAkBA,cAAM,eAAe;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,KAAK,CAAmB;;IAkChC,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,aAAa;IAoDf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAsB7B;AAkCD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/index.js

@@ -13,6 +13,7 @@ const gemini_1 = require("./services/gemini");
 const gemini_chat_1 = require("./tools/gemini-chat");
 const gemini_list_models_1 = require("./tools/gemini-list-models");
 const gemini_deep_research_1 = require("./tools/gemini-deep-research");
+const gemini_describe_video_1 = require("./tools/gemini-describe-video");
 const logger_1 = __importDefault(require("./utils/logger"));
 const error_handler_1 = require("./utils/error-handler");
 class GeminiMcpServer {
@@ -48,9 +49,11 @@ class GeminiMcpServer {
         const geminiChatTool = new gemini_chat_1.GeminiChatTool(this.geminiService);
         const geminiListModelsTool = new gemini_list_models_1.GeminiListModelsTool(this.geminiService);
         const geminiDeepResearchTool = new gemini_deep_research_1.GeminiDeepResearchTool(this.geminiService);
+        const geminiDescribeVideoTool = new gemini_describe_video_1.GeminiDescribeVideoTool(this.geminiService);
         this.tools.set('gemini_chat', geminiChatTool);
         this.tools.set('gemini_list_models', geminiListModelsTool);
         this.tools.set('gemini_deep_research', geminiDeepResearchTool);
+        this.tools.set('gemini_describe_video', geminiDescribeVideoTool);
         logger_1.default.info('Tools initialized', {
             toolCount: this.tools.size,
             tools: Array.from(this.tools.keys())

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/gemini-describe-video.d.ts

@@ -0,0 +1,38 @@
+import { TextContent, Tool } from '@modelcontextprotocol/sdk/types.js';
+import { GeminiService } from '../services/gemini';
+export interface VideoDescriptionRequest {
+    url: string;
+    detail_level?: 'brief' | 'standard' | 'comprehensive';
+    accessibility_mode?: boolean;
+    include_timestamps?: boolean;
+    output_format?: 'narrative' | 'structured';
+    focus?: 'actions' | 'visual_elements' | 'text_on_screen' | 'all';
+}
+export interface VideoScene {
+    timestamp: string;
+    description: string;
+    actions?: string[];
+    tools_visible?: string[];
+    text_on_screen?: string | null;
+    spatial_notes?: string;
+    colors?: string;
+}
+export interface StructuredVideoDescription {
+    video_title?: string;
+    duration?: string;
+    scene_count: number;
+    scenes: VideoScene[];
+    key_techniques?: string[];
+    tools_list?: string[];
+    materials_list?: string[];
+    safety_notes?: string[];
+    summary: string;
+}
+export declare class GeminiDescribeVideoTool {
+    private geminiService;
+    constructor(geminiService: GeminiService);
+    getDefinition(): Tool;
+    private buildAccessibilityPrompt;
+    execute(args: any): Promise<TextContent[]>;
+}
+//# sourceMappingURL=gemini-describe-video.d.ts.map

package/dist/tools/gemini-describe-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-describe-video.d.ts","sourceRoot":"","sources":["../../src/tools/gemini-describe-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,eAAe,CAAC;IACtD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;IAC3C,KAAK,CAAC,EAAE,SAAS,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,KAAK,CAAC;CAClE;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,uBAAuB;IACtB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAEhD,aAAa,IAAI,IAAI;IA6CrB,OAAO,CAAC,wBAAwB;IA8E1B,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CA4EjD"}

package/dist/tools/gemini-describe-video.js

@@ -0,0 +1,196 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiDescribeVideoTool = void 0;
+const error_handler_1 = require("../utils/error-handler");
+const logger_1 = __importDefault(require("../utils/logger"));
+class GeminiDescribeVideoTool {
+    geminiService;
+    constructor(geminiService) {
+        this.geminiService = geminiService;
+    }
+    getDefinition() {
+        return {
+            name: 'gemini_describe_video',
+            description: 'Generate detailed audio description of YouTube video content for accessibility. Analyzes visual content including actions, spatial relationships, text overlays, and provides time-stamped descriptions.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    url: {
+                        type: 'string',
+                        description: 'YouTube URL to analyze'
+                    },
+                    detail_level: {
+                        type: 'string',
+                        enum: ['brief', 'standard', 'comprehensive'],
+                        default: 'standard',
+                        description: 'Level of detail in descriptions: brief (high-level summary), standard (balanced), comprehensive (extensive detail)'
+                    },
+                    accessibility_mode: {
+                        type: 'boolean',
+                        default: true,
+                        description: 'Include spatial descriptions, colors, text overlays, and other visual details important for accessibility'
+                    },
+                    include_timestamps: {
+                        type: 'boolean',
+                        default: true,
+                        description: 'Include timestamps for all major actions and scene changes'
+                    },
+                    output_format: {
+                        type: 'string',
+                        enum: ['narrative', 'structured'],
+                        default: 'structured',
+                        description: 'Output format: narrative (prose description) or structured (JSON with sections for easy navigation)'
+                    },
+                    focus: {
+                        type: 'string',
+                        enum: ['actions', 'visual_elements', 'text_on_screen', 'all'],
+                        default: 'all',
+                        description: 'What aspects to focus on: actions (what people do), visual_elements (objects, colors, composition), text_on_screen (captions, overlays), or all'
+                    }
+                },
+                required: ['url']
+            }
+        };
+    }
+    buildAccessibilityPrompt(request) {
+        const detailLevelInstructions = {
+            brief: 'Provide a concise 2-3 paragraph summary of the video content.',
+            standard: 'Provide a balanced description with key scenes and actions, approximately 5-8 scenes.',
+            comprehensive: 'Provide extensive detail for every significant action and visual element, breaking the video into 10-15+ distinct scenes.'
+        };
+        const focusInstructions = {
+            actions: 'Focus primarily on what people are doing - movements, gestures, tool usage, and procedures.',
+            visual_elements: 'Focus on visual composition - objects, colors, spatial relationships, and visual design.',
+            text_on_screen: 'Focus on any text, captions, overlays, or written information visible in the video.',
+            all: 'Provide comprehensive coverage of actions, visual elements, and text equally.'
+        };
+        const accessibilityInstructions = request.accessibility_mode ? `
+ACCESSIBILITY MODE REQUIREMENTS:
+- Describe spatial relationships explicitly (e.g., "on the left side of the frame", "in the upper right corner", "moving from left to right")
+- Include colors where relevant to understanding (e.g., "red laser line", "blue button")
+- Transcribe ALL text overlays, captions, and on-screen text verbatim
+- Describe facial expressions and body language when relevant
+- Note sound cues if visible (e.g., "person speaking", "tool making noise", "music playing")
+- Use clear, concrete language - avoid "this", "that", "here", "there" without context
+- Describe what IS happening, not what viewers should do
+- For tools and objects, describe them before using pronouns
+` : '';
+        const timestampInstructions = request.include_timestamps ? `
+- Include precise timestamps for every scene or major action (format: MM:SS or H:MM:SS)
+- Mark when new scenes begin, when actions change, when new tools appear
+` : '';
+        const outputFormatInstructions = request.output_format === 'structured' ? `
+OUTPUT FORMAT: Return a valid JSON object with this exact structure:
+{
+  "video_title": "Brief title if discernible",
+  "duration": "Total video length (MM:SS format)",
+  "scene_count": number,
+  "scenes": [
+    {
+      "timestamp": "0:00-0:45",
+      "description": "Detailed description of what's happening",
+      "actions": ["action 1", "action 2"],
+      "tools_visible": ["tool 1", "tool 2"],
+      "text_on_screen": "Exact text shown, or null",
+      "spatial_notes": "Spatial relationships if relevant",
+      "colors": "Color descriptions if relevant"
+    }
+  ],
+  "key_techniques": ["technique 1", "technique 2"],
+  "tools_list": ["complete list of all tools shown"],
+  "materials_list": ["all materials used"],
+  "safety_notes": ["any safety considerations visible"],
+  "summary": "2-3 sentence overall summary"
+}
+
+CRITICAL: Return ONLY valid JSON. Do not include any text before or after the JSON object.
+` : `
+OUTPUT FORMAT: Return a narrative prose description with clear paragraphs.
+${request.include_timestamps ? 'Start each major section with timestamps in [MM:SS] format.' : ''}
+`;
+        return `You are analyzing a YouTube video to create an audio description for accessibility purposes.
+
+VIDEO URL: ${request.url}
+
+DETAIL LEVEL: ${request.detail_level || 'standard'}
+${detailLevelInstructions[request.detail_level || 'standard']}
+
+FOCUS: ${request.focus || 'all'}
+${focusInstructions[request.focus || 'all']}
+
+${accessibilityInstructions}
+${timestampInstructions}
+${outputFormatInstructions}
+
+Analyze the video and provide the description according to these requirements.`;
+    }
+    async execute(args) {
+        try {
+            logger_1.default.info('Executing gemini_describe_video tool', {
+                url: args.url,
+                detail_level: args.detail_level,
+                accessibility_mode: args.accessibility_mode,
+                output_format: args.output_format
+            });
+            if (!args.url) {
+                throw new error_handler_1.McpError('URL is required', 'INVALID_PARAMS');
+            }
+            // Validate YouTube URL
+            if (!args.url.includes('youtube.com') && !args.url.includes('youtu.be')) {
+                throw new error_handler_1.McpError('Only YouTube URLs are supported', 'INVALID_PARAMS');
+            }
+            const request = {
+                url: args.url,
+                detail_level: args.detail_level || 'standard',
+                accessibility_mode: args.accessibility_mode !== false, // Default true
+                include_timestamps: args.include_timestamps !== false, // Default true
+                output_format: args.output_format || 'structured',
+                focus: args.focus || 'all'
+            };
+            const prompt = this.buildAccessibilityPrompt(request);
+            // Use Gemini 2.5 Flash for video understanding (best model for this task)
+            const response = await this.geminiService.chat({
+                message: prompt,
+                model: 'gemini-2.5-flash',
+                temperature: 0.3, // Lower temperature for more consistent, factual descriptions
+                maxTokens: 16000, // Comprehensive descriptions may be lengthy
+                grounding: false // Don't use web search for video analysis
+            });
+            // If structured output requested, try to parse and validate JSON
+            if (request.output_format === 'structured') {
+                try {
+                    // Remove markdown code blocks if present
+                    let cleanedContent = response.content.trim();
+                    cleanedContent = cleanedContent.replace(/```json\n?/g, '').replace(/```\n?/g, '');
+                    const parsed = JSON.parse(cleanedContent);
+                    // Validate basic structure
+                    if (!parsed.scenes || !Array.isArray(parsed.scenes)) {
+                        logger_1.default.warn('Structured output missing scenes array, returning raw response');
+                        return (0, error_handler_1.createToolResult)(true, response.content);
+                    }
+                    // Return formatted JSON
+                    return (0, error_handler_1.createToolResult)(true, JSON.stringify(parsed, null, 2));
+                }
+                catch (parseError) {
+                    logger_1.default.warn('Failed to parse structured output as JSON, returning raw response', {
+                        error: parseError.message
+                    });
+                    return (0, error_handler_1.createToolResult)(true, response.content);
+                }
+            }
+            return (0, error_handler_1.createToolResult)(true, response.content);
+        }
+        catch (error) {
+            logger_1.default.error('gemini_describe_video tool execution failed', { error });
+            if (error instanceof error_handler_1.McpError) {
+                return (0, error_handler_1.createToolResult)(false, error.message, error);
+            }
+            return (0, error_handler_1.createToolResult)(false, `Unexpected error: ${error.message}`, error);
+        }
+    }
+}
+exports.GeminiDescribeVideoTool = GeminiDescribeVideoTool;
+//# sourceMappingURL=gemini-describe-video.js.map

package/dist/tools/gemini-describe-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-describe-video.js","sourceRoot":"","sources":["../../src/tools/gemini-describe-video.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@houtini/gemini-mcp",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "Professional Model Context Protocol server for Google Gemini AI models with enterprise-grade features",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",