@felores/mcp-video 0.5.3

package/documentation/mcp-llm-guide.md

@@ -0,0 +1,379 @@
+# MCP Development Guide for LLMs
+
+This guide provides structured information for LLMs to assist in creating, modifying, and using Model Context Protocol (MCP) servers.
+
+## 1. Core Concepts
+
+### Protocol Overview
+- MCP enables standardized communication between LLM applications and integrations
+- Uses client-server architecture with JSON-RPC 2.0 message format
+- Latest protocol version: 2024-11-05
+- Supports stdio and SSE transports
+
+### Key Components
+1. **Hosts**: LLM applications that initiate connections (e.g., Claude Desktop)
+2. **Clients**: Maintain 1:1 connections with servers
+3. **Servers**: Provide context, tools, and prompts to clients
+4. **Resources**: File-like data that can be read by clients
+5. **Tools**: Functions that can be called by the LLM
+6. **Prompts**: Pre-written templates for specific tasks
+
+## 2. Server Implementation Guidelines
+
+### Server Structure
+1. Core Server Class:
+```typescript
+class Server extends Protocol<ServerRequest, ServerNotification, ServerResult> {
+    constructor(serverInfo: Implementation, options: ServerOptions)
+    // Must implement base protocol methods
+}
+```
+
+2. Required Capabilities:
+```typescript
+interface ServerCapabilities {
+    experimental?: object;
+    logging?: object;
+    prompts?: { listChanged?: boolean };
+    resources?: { 
+        subscribe?: boolean;
+        listChanged?: boolean 
+    };
+    tools?: { listChanged?: boolean };
+}
+```
+
+### Essential Implementation Steps
+
+1. **Server Initialization**:
+```typescript
+const server = new Server(
+    {
+        name: "your-server-name",
+        version: "1.0.0"
+    },
+    {
+        capabilities: {
+            // Declare supported capabilities
+            resources: {},
+            tools: {},
+            prompts: {}
+        }
+    }
+);
+```
+
+2. **Request Handlers**:
+```typescript
+// Example tool handler
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "tool-name",
+            description: "Tool description",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    // Define parameters
+                }
+            }
+        }
+    ]
+}));
+```
+
+3. **Transport Setup**:
+```typescript
+const transport = new StdioServerTransport();
+await server.connect(transport);
+```
+
+## 3. Core Features Implementation
+
+### Resources
+```typescript
+interface Resource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+
+// Handler example
+server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+    resources: [
+        {
+            uri: "custom://resource",
+            name: "Resource Name",
+            description: "Resource description"
+        }
+    ]
+}));
+```
+
+### Tools
+```typescript
+interface Tool {
+    name: string;
+    description?: string;
+    inputSchema: {
+        type: "object";
+        properties?: object;
+        required?: string[];
+    };
+}
+
+// Handler example
+server.setRequestHandler(CallToolRequestSchema, async (request) => ({
+    content: [
+        {
+            type: "text",
+            text: "Tool execution result"
+        }
+    ]
+}));
+```
+
+### Prompts
+```typescript
+interface Prompt {
+    name: string;
+    description?: string;
+    arguments?: PromptArgument[];
+}
+
+// Handler example
+server.setRequestHandler(GetPromptRequestSchema, async (request) => ({
+    messages: [
+        {
+            role: "user",
+            content: {
+                type: "text",
+                text: "Prompt template"
+            }
+        }
+    ]
+}));
+```
+
+## 4. Best Practices
+
+### Error Handling
+1. Use appropriate error codes:
+```typescript
+enum ErrorCode {
+    ParseError = -32700,
+    InvalidRequest = -32600,
+    MethodNotFound = -32601,
+    InvalidParams = -32602,
+    InternalError = -32603
+}
+```
+
+2. Tool errors should be in result:
+```typescript
+{
+    isError: true,
+    content: [{
+        type: "text",
+        text: "Error description"
+    }]
+}
+```
+
+### Security Considerations
+1. Input Validation:
+   - Validate all parameters against schemas
+   - Sanitize file paths and system commands
+   - Validate URLs and external identifiers
+   - Check parameter sizes and ranges
+
+2. Access Control:
+   - Implement authentication where needed
+   - Use appropriate authorization checks
+   - Audit tool usage
+   - Rate limit requests
+
+3. Resource Protection:
+   - Validate resource paths
+   - Monitor resource usage
+   - Implement access controls
+   - Rate limit requests
+
+### Message Handling
+1. Request Processing:
+   - Validate inputs thoroughly
+   - Use type-safe schemas
+   - Handle errors gracefully
+   - Implement timeouts
+
+2. Progress Reporting:
+   - Use progress tokens for long operations
+   - Report progress incrementally
+   - Include total progress when known
+
+## 5. Client Integration Guidelines
+
+### Client Configuration
+```json
+{
+    "mcpServers": {
+        "server-name": {
+            "command": "command-to-run",
+            "args": ["arg1", "arg2"],
+            "env": {
+                "ENV_VAR": "value"
+            }
+        }
+    }
+}
+```
+
+### Environment Variables
+- Server inherits limited environment variables
+- Custom variables must be specified in config
+- Sensitive data should be in environment variables
+
+## 6. Testing and Debugging
+
+### MCP Inspector Usage
+1. Start inspector with server:
+```bash
+npx mcp-inspector your-server-command
+```
+
+2. Features to test:
+   - Resource listing and reading
+   - Tool execution
+   - Prompt generation
+   - Error handling
+   - Progress reporting
+
+### Common Issues
+1. Connection Problems:
+   - Check transport configuration
+   - Verify server process is running
+   - Check for initialization errors
+
+2. Message Handling:
+   - Validate message formats
+   - Check handler implementations
+   - Verify error responses
+
+3. Resource Issues:
+   - Check file permissions
+   - Validate URI formats
+   - Verify content types
+
+## 7. Performance and Scaling
+
+### Best Practices
+1. Resource Management:
+   - Cache when appropriate
+   - Implement cleanup
+   - Monitor memory usage
+
+2. Request Handling:
+   - Use appropriate timeouts
+   - Implement rate limiting
+   - Handle concurrent requests
+
+3. Error Recovery:
+   - Implement reconnection logic
+   - Handle partial failures
+   - Clean up resources
+
+## 8. Documentation Requirements
+
+### Server Documentation
+1. Capabilities Documentation:
+   - List supported features
+   - Document configuration options
+   - Describe environment variables
+
+2. API Documentation:
+   - Document all resources
+   - Document all tools
+   - Document all prompts
+   - Include example usage
+
+3. Error Documentation:
+   - List possible error codes
+   - Describe error conditions
+   - Include recovery steps
+
+### Integration Guide
+1. Setup Instructions:
+   - Installation steps
+   - Configuration options
+   - Environment setup
+
+2. Usage Examples:
+   - Basic usage patterns
+   - Common integrations
+   - Error handling examples
+
+## 9. Versioning and Updates
+
+### Version Management
+1. Protocol Versioning:
+   - Support LATEST_PROTOCOL_VERSION
+   - Handle version negotiation
+   - Maintain compatibility
+
+2. Server Versioning:
+   - Use semantic versioning
+   - Document breaking changes
+   - Provide migration guides
+
+### Update Handling
+1. Capability Updates:
+   - Notify clients of changes
+   - Handle capability negotiation
+   - Maintain backwards compatibility
+
+2. Resource Updates:
+   - Handle resource changes
+   - Notify subscribed clients
+   - Maintain consistency
+
+## 10. Specific Server Types
+
+### Database Servers (like Airtable)
+1. Required Capabilities:
+   - Resources for data access
+   - Tools for data manipulation
+   - Prompts for common operations
+
+2. Implementation Focus:
+   - Connection management
+   - Query handling
+   - Data transformation
+   - Error handling
+   - Rate limiting
+
+3. Security Considerations:
+   - API key management
+   - Access control
+   - Data validation
+   - Request sanitization
+
+4. Tools to Implement:
+   - List databases/bases
+   - Create/modify tables
+   - Query data
+   - Update records
+   - Delete records
+
+5. Resource Structure:
+   - Database schema
+   - Table contents
+   - Query results
+
+6. Error Handling:
+   - Connection errors
+   - Query errors
+   - Rate limit errors
+   - Authorization errors
+
+This guide should be used as a reference when assisting with MCP server development. Always consider the specific requirements and constraints of the project while following these guidelines.

package/eslint.config.mjs

@@ -0,0 +1,88 @@
+import typescriptEslint from "@typescript-eslint/eslint-plugin";
+import prettier from "eslint-plugin-prettier";
+import tsParser from "@typescript-eslint/parser";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import js from "@eslint/js";
+import { FlatCompat } from "@eslint/eslintrc";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+  recommendedConfig: js.configs.recommended,
+  allConfig: js.configs.all,
+});
+
+export default [
+  ...compat.extends(
+    "eslint:recommended",
+    "prettier",
+    "plugin:@typescript-eslint/eslint-recommended",
+    "plugin:@typescript-eslint/recommended",
+  ),
+  {
+    files: ["./src/*.{ts,tsx}", "./test/*.{ts,tsx}"],
+    plugins: {
+      "@typescript-eslint": typescriptEslint,
+      prettier,
+    },
+
+    languageOptions: {
+      globals: {},
+      parser: tsParser,
+      ecmaVersion: 5,
+      sourceType: "script",
+
+      parserOptions: {
+        project: "./tsconfig.json",
+      },
+    },
+
+    rules: {
+      "prettier/prettier": "warn",
+
+      "spaced-comment": [
+        "error",
+        "always",
+        {
+          markers: ["/"],
+        },
+      ],
+
+      "no-fallthrough": "error",
+      "@typescript-eslint/ban-ts-comment": "warn",
+
+      "@typescript-eslint/consistent-type-imports": [
+        "error",
+        {
+          prefer: "type-imports",
+        },
+      ],
+
+      "@typescript-eslint/no-inferrable-types": [
+        "error",
+        {
+          ignoreParameters: false,
+          ignoreProperties: false,
+        },
+      ],
+
+      "@typescript-eslint/no-non-null-assertion": "off",
+      "@typescript-eslint/no-floating-promises": "error",
+
+      "@typescript-eslint/no-unused-vars": [
+        "warn",
+        {
+          args: "after-used",
+          argsIgnorePattern: "^_",
+          varsIgnorePattern: "^_",
+          ignoreRestSiblings: true,
+        },
+      ],
+
+      "@typescript-eslint/no-empty-function": ["error"],
+      "@typescript-eslint/restrict-template-expressions": "off",
+    },
+  },
+];

package/lib/index.d.mts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/lib/index.mjs

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import * as os from "os";
+import * as fs from "fs";
+import * as path from "path";
+import { spawnPromise } from "spawn-rx";
+import { rimraf } from "rimraf";
+import { cleanSubtitles } from "./vtt2txt.mjs";
+// Get downloads directory from env or default to project root
+const DOWNLOADS_DIR = process.env.DOWNLOADS_DIR || path.join(process.cwd(), "downloads");
+console.error('Using downloads directory:', DOWNLOADS_DIR);
+const server = new Server({
+    name: "mcp-video",
+    version: "0.5.1",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "get_video_transcript",
+                description: "Download and process video subtitles for analysis from various platforms (YouTube, Vimeo, Twitter/X, TikTok, etc.) using yt-dlp. Use this tool when asked to summarize, analyze, or extract information from any video that has subtitles/closed captions. This enables Claude to understand video content through subtitles.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        url: { type: "string", description: "URL of the video from any supported platform (YouTube, Vimeo, Twitter/X, TikTok, etc.)" },
+                    },
+                    required: ["url"],
+                },
+            },
+            {
+                name: "download_video",
+                description: "Download video in best quality (limited to 1080p) from various platforms (YouTube, Vimeo, Twitter/X, TikTok, etc.) using yt-dlp. Downloads are stored in the downloads directory. IMPORTANT: Clients should always provide a sanitized filename using the platform and video ID format to ensure consistent naming and avoid conflicts.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        url: { type: "string", description: "URL of the video from any supported platform (YouTube, Vimeo, Twitter/X, TikTok, etc.)" },
+                        filename: {
+                            type: "string",
+                            description: "Sanitized filename using platform-id format. Examples:\n- YouTube: youtube-{video_id} (e.g. 'youtube-MhOTvvmlqLM' from youtube.com/watch?v=MhOTvvmlqLM)\n- Twitter/X: x-{tweet_id} (e.g. 'x-1876565449615217019' from x.com/user/status/1876565449615217019)\n- Vimeo: vimeo-{video_id} (e.g. 'vimeo-123456789' from vimeo.com/123456789)"
+                        },
+                    },
+                    required: ["url"],
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (request.params.name === "get_video_transcript") {
+        try {
+            const { url } = request.params.arguments;
+            const tempDir = fs.mkdtempSync(`${os.tmpdir()}${path.sep}youtube-`);
+            await spawnPromise("yt-dlp", [
+                "--write-sub",
+                "--write-auto-sub",
+                "--sub-lang",
+                "en",
+                "--skip-download",
+                "--sub-format",
+                "srt",
+                url,
+            ], { cwd: tempDir, detached: true });
+            let content = "";
+            try {
+                fs.readdirSync(tempDir).forEach((file) => {
+                    const fileContent = fs.readFileSync(path.join(tempDir, file), "utf8");
+                    const cleanedContent = cleanSubtitles(fileContent);
+                    content += `${cleanedContent}\n\n`;
+                });
+            }
+            finally {
+                rimraf.sync(tempDir);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: content,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error downloading video: ${err}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    else if (request.params.name === "download_video") {
+        try {
+            const { url, filename } = request.params.arguments;
+            // Create downloads directory if it doesn't exist
+            try {
+                if (!fs.existsSync(DOWNLOADS_DIR)) {
+                    fs.mkdirSync(DOWNLOADS_DIR, { recursive: true });
+                }
+                console.error('Downloads directory created/verified at:', DOWNLOADS_DIR);
+            }
+            catch (err) {
+                console.error('Error creating downloads directory:', err);
+                throw err;
+            }
+            // Get video info first
+            const infoResult = await spawnPromise("yt-dlp", [
+                "--print",
+                "%(title)s",
+                "--print",
+                "%(duration)s",
+                "--print",
+                "%(resolution)s",
+                url,
+            ]);
+            const [title, duration, resolution] = infoResult.split("\n");
+            // Prepare output template with absolute path
+            const outputTemplate = filename ?
+                path.join(DOWNLOADS_DIR, `${filename}.mp4`) :
+                path.join(DOWNLOADS_DIR, "%(title)s.%(ext)s");
+            // Download the video
+            await spawnPromise("yt-dlp", [
+                "-f",
+                "((bv*[height<=1080])/bv*)+ba/b",
+                "--merge-output-format",
+                "mp4",
+                "-o",
+                outputTemplate,
+                url,
+            ]);
+            // Get the final file size
+            const finalPath = filename ?
+                path.join(DOWNLOADS_DIR, `${filename}.mp4`) :
+                path.join(DOWNLOADS_DIR, `${title}.mp4`);
+            const stats = fs.statSync(finalPath);
+            const fileSizeMB = (stats.size / (1024 * 1024)).toFixed(2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Successfully downloaded video:
+Title: ${title}
+Duration: ${duration} seconds
+Resolution: ${resolution}
+File size: ${fileSizeMB} MB
+Saved to: ${finalPath}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error downloading video: ${err}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    else {
+        throw new Error(`Unknown tool: ${request.params.name}`);
+    }
+});
+async function runServer() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+runServer().catch(console.error);
+//# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

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

package/lib/vtt2txt.d.mts

@@ -0,0 +1 @@
+export declare function cleanSubtitles(vttContent: string): string;

package/lib/vtt2txt.mjs

@@ -0,0 +1,22 @@
+export function cleanSubtitles(vttContent) {
+    // Split into lines
+    const lines = vttContent.split('\n');
+    const cleanedText = new Set(); // Use Set to remove duplicates
+    for (let line of lines) {
+        // Skip WebVTT header, timestamps, and empty lines
+        if (line.trim() === 'WEBVTT' || line.trim() === '' || /^\d{2}:\d{2}/.test(line)) {
+            continue;
+        }
+        // Remove HTML-style tags and clean the text
+        line = line.replace(/<[^>]*>/g, '')
+            .replace(/\[.*?\]/g, '') // Remove square brackets and their contents
+            .trim();
+        // If we have actual text, add it
+        if (line) {
+            cleanedText.add(line);
+        }
+    }
+    // Convert Set back to array and join with newlines
+    return Array.from(cleanedText).join('\n');
+}
+//# sourceMappingURL=vtt2txt.mjs.map

package/lib/vtt2txt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vtt2txt.mjs","sourceRoot":"","sources":["../src/vtt2txt.mts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC7C,mBAAmB;IACnB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC,CAAC,+BAA+B;IAEtE,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;QACrB,kDAAkD;QAClD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9E,SAAS;QACb,CAAC;QAED,4CAA4C;QAC5C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;aACxB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,4CAA4C;aACpE,IAAI,EAAE,CAAC;QAElB,iCAAiC;QACjC,IAAI,IAAI,EAAE,CAAC;YACP,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACL,CAAC;IAED,mDAAmD;IACnD,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC"}