video-context-mcp-server 1.0.0-beta.10

package/README.md

@@ -0,0 +1,380 @@
+# Video Context MCP Server
+
+Video Context MCP Server is a Model Context Protocol (MCP) server that gives MCP-compatible coding assistants (such as GitHub Copilot in VS Code, Cursor, and Claude Code) the ability to understand and analyze video content. Supports three AI backends: **Gemini 3 Flash Preview** (Google), **Kimi K2.5** (Moonshot AI), and **GLM-4.6V** (Z.AI).
+
+## Features
+
+- 🎬 **Video Q&A** — Ask questions about video content and get AI-powered answers
+- 📝 **Video Summarization** — Generate structured summaries with key scenes and timelines
+- 🖼️ **Frame Extraction** — Extract frames at specific timestamps or intervals
+- 🔍 **Timestamp Search** — Find the exact moment when something happens in a video
+- 📊 **Video Metadata** — Get duration, resolution, fps, codec, and other technical details
+- 🔄 **Multi-Backend Support** — Choose between Gemini (native multimodal), GLM-4.6V (cheap/free), or Kimi K2.5 (broader format support)
+- 🎯 **Smart Video Handling** — Extracts keyframes from long videos to reduce token usage (when not using Gemini)
+
+## Installation
+
+### Quick Start (Recommended for ordinary users)
+
+#### 1. Prerequisites
+
+- Node.js 18+
+- VS Code with GitHub Copilot Chat enabled
+
+#### 2. Get API keys
+
+You'll need API keys for one or more backends:
+
+- **Gemini 3 Flash Preview (Google)**: [Get API Key](https://aistudio.google.com/app/apikey)
+- **Kimi K2.5 (Moonshot AI)**: [Get API Key](https://platform.moonshot.ai)
+- **GLM-4.6V (Z.AI)**: [Get API Key](https://z.ai/manage-apikey/apikey-list)
+
+#### 3. Install the MCP server
+
+```bash
+npm install -g video-context-mcp-server
+```
+
+This installs the executable command: `video-context-mcp`.
+
+> **Tip:** Periodically re-run the above command to get the latest version:
+>
+> ```bash
+> npm install -g video-context-mcp-server@latest
+> ```
+
+#### 4. Configure VS Code MCP
+
+Create (or update) `.vscode/mcp.json` in your project/workspace:
+
+```json
+{
+  "servers": {
+    "videoMcp": {
+      "type": "stdio",
+      "command": "video-context-mcp",
+      "env": {
+        "GEMINI_API_KEY": "your-gemini-key",
+        "MOONSHOT_API_KEY": "your-moonshot-key",
+        "Z_AI_API_KEY": "your-zai-key"
+      }
+    }
+  }
+}
+```
+
+Open Copilot Chat in VS Code. The MCP server starts automatically when tools are needed.
+
+### Configure Cursor MCP
+
+Add this server to your Cursor MCP configuration (global or project-level):
+
+```json
+{
+  "mcpServers": {
+    "videoMcp": {
+      "command": "video-context-mcp",
+      "env": {
+        "GEMINI_API_KEY": "your-gemini-key",
+        "MOONSHOT_API_KEY": "your-moonshot-key",
+        "Z_AI_API_KEY": "your-zai-key"
+      }
+    }
+  }
+}
+```
+
+Notes:
+
+- Run `npm install -g video-context-mcp-server` first if you haven't already.
+- If you prefer not to install globally, use `npx -y video-context-mcp-server@latest` as the command (slower startup due to registry check).
+- Set one or both API keys depending on which provider you use.
+
+### Configure Claude Code MCP
+
+Use the Claude CLI to register the MCP server:
+
+```bash
+claude mcp add videoMcp video-context-mcp \
+  --env GEMINI_API_KEY=your-gemini-key \
+  --env MOONSHOT_API_KEY=your-moonshot-key \
+  --env Z_AI_API_KEY=your-zai-key
+```
+
+Then verify with:
+
+```bash
+claude mcp list
+```
+
+If you prefer not to install globally, register via `npx` instead (slower startup due to registry check):
+
+```bash
+claude mcp add videoMcp npx -y video-context-mcp-server@latest \
+  --env MOONSHOT_API_KEY=your-moonshot-key \
+  --env Z_AI_API_KEY=your-zai-key
+```
+
+### Troubleshooting Setup
+
+- **`video-context-mcp: command not found`**
+  - Make sure Node.js is installed and available in your shell (`node -v`, `npm -v`).
+  - If installed globally, re-run: `npm install -g video-context-mcp-server`.
+  - If global binaries are not on PATH, use `npx -y video-context-mcp-server@latest` instead of `video-context-mcp`.
+
+- **MCP server not appearing in client**
+  - Restart the client app after changing MCP configuration.
+  - Validate JSON syntax in your MCP config file.
+  - For Claude Code, verify registration with `claude mcp list`.
+
+- **Missing API key errors**
+  - Set `GEMINI_API_KEY` for Gemini usage, `Z_AI_API_KEY` for GLM usage, and `MOONSHOT_API_KEY` for Kimi usage.
+  - You can set only one key if you only use one provider.
+  - For local files, if `provider=gemini` is requested but `GEMINI_API_KEY` is missing, the server automatically falls back to GLM (and then Kimi) when those keys are available.
+  - For remote `http(s)` video URLs, use `provider=gemini` or `provider=glm` (Kimi requires local file input). Gemini will automatically download the remote video to a temporary file before processing.
+
+### Alternative: Run via npx without global install
+
+If you prefer not to install globally, you can use `npx` instead. Note this adds a startup delay due to the npm registry check on each run:
+
+```json
+{
+  "servers": {
+    "videoMcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "video-context-mcp-server@latest"],
+      "env": {
+        "GEMINI_API_KEY": "your-gemini-key",
+        "MOONSHOT_API_KEY": "your-moonshot-key",
+        "Z_AI_API_KEY": "your-zai-key"
+      }
+    }
+  }
+}
+```
+
+The `@latest` tag ensures you always get the newest published version, at the cost of a network round-trip on every startup — this also means the `npx` approach self-updates automatically and requires no manual update step.
+
+### For contributors: install from source
+
+Clone this repository, then:
+
+```bash
+npm install
+npm run build
+```
+
+Then use this `.vscode/mcp.json` server command:
+
+```json
+{
+  "servers": {
+    "videoMcp": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["${workspaceFolder}/dist/index.js"],
+      "env": {
+        "GEMINI_API_KEY": "your-gemini-key",
+        "MOONSHOT_API_KEY": "your-moonshot-key",
+        "Z_AI_API_KEY": "your-zai-key"
+      }
+    }
+  }
+}
+```
+
+### Debugging Behavior in VS Code
+
+When your `.vscode/mcp.json` includes a `dev` block such as:
+
+```jsonc
+{
+  "servers": {
+    "videoMcp": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["${workspaceFolder}/dist/index.js"],
+      "env": {
+        "GEMINI_API_KEY": "your-gemini-key",
+        "MOONSHOT_API_KEY": "your-moonshot-key",
+        "Z_AI_API_KEY": "your-zai-key",
+      },
+      "dev": {
+        "watch": "src/**/*.ts",
+        "debug": { "type": "node" },
+      },
+    },
+  },
+}
+```
+
+you may see frequent logs in the **Output** panel under `MCP: videoMcp`.
+
+This is expected in development mode:
+
+- `watch` restarts/reloads the MCP server when TypeScript files change
+- `debug` enables Node debug integration
+- MCP protocol payloads (tool schemas, discovery events, lifecycle messages) are printed in that output channel
+
+If you want less noise, remove either:
+
+- `dev.debug` (keeps auto-watch, disables debug integration), or
+- the full `dev` block (disables watch + debug behavior)
+
+## Available Tools
+
+| Tool               | Description                          | Parameters                                          |
+| ------------------ | ------------------------------------ | --------------------------------------------------- |
+| `analyze_video`    | Ask questions about video content    | `videoPath`, `question`, `provider?`                |
+| `summarize_video`  | Generate a structured video summary  | `videoPath`, `provider?`                            |
+| `extract_frames`   | Extract frames from a video          | `videoPath`, `mode`, `count/intervalSec/timestamps` |
+| `search_timestamp` | Find when something specific happens | `videoPath`, `query`, `provider?`                   |
+| `get_video_info`   | Get video metadata                   | `videoPath`                                         |
+
+### Path and Provider Constraints
+
+- `analyze_video` and `summarize_video` support local files and `http(s)` URLs.
+- For remote `http(s)` URLs, `provider=gemini` and `provider=glm` are supported. `provider=kimi` requires a local file.
+- `search_timestamp`, `extract_frames`, and `get_video_info` currently support local files only.
+- For local inputs, `analyze_video`, `summarize_video`, and `search_timestamp` accept normal paths or `file://` URIs.
+- `extract_frames` and `get_video_info` currently expect local filesystem path strings.
+
+## Usage Examples
+
+### Analyze Video
+
+Ask Copilot Chat:
+
+> "Analyze the video at `./demo.mp4` and tell me what happens in it"
+
+### Summarize Video
+
+> "Summarize the video at `./long-video.mp4`"
+
+### Extract Frames
+
+> "Extract 5 evenly-spaced frames from `./video.mp4`"
+
+> "Extract a frame at timestamp 30 seconds from `./video.mp4`"
+
+### Search Timestamp
+
+> "In `./video.mp4`, at what timestamp does the person wave?"
+
+### Get Video Info
+
+> "Get the video info for `./video.mp4`"
+
+## Additional Guides
+
+- [Screen Recording for Small File Sizes (Windows)](docs/screen-recording-small-files.md)
+
+## Backend Comparison
+
+| Feature        | Gemini 3 Flash Preview                         | GLM-4.6V                       | Kimi K2.5                                      |
+| -------------- | ---------------------------------------------- | ------------------------------ | ---------------------------------------------- |
+| Video formats  | mp4, mpeg, mov, avi, flv, mpg, webm, wmv, 3gpp | mp4, avi, mov, wmv, webm, m4v  | mp4, mpeg, mov, avi, flv, mpg, webm, wmv, 3gpp |
+| Price          | Free tier available                            | $0.30 input / $0.90 output     | $0.60 input / $3.00 output                     |
+| Free tier      | Yes                                            | Yes (GLM-4.6V-Flash)           | No                                             |
+| Context window | 1M tokens                                      | 128K                           | 256K                                           |
+| Max file size  | 2 GB                                           | ~20 MB (base64)                | 100 MB                                         |
+| Best for       | Fallback only (inaccurate despite features)    | **Default**, accurate analysis | Paid fallback                                  |
+
+**GLM-4.6V is the default backend** — it provides the most accurate video analysis results. While Gemini 3 Flash Preview offers superior features (1M token context, 2GB file size, native multimodal audio+video support), it has **proven inaccurate for video content analysis** in practice. Use Kimi K2.5 as the **first fallback** when GLM is unavailable, and Gemini as the **last resort fallback**. Set `VIDEO_MCP_DEFAULT_PROVIDER=kimi` or `VIDEO_MCP_DEFAULT_PROVIDER=gemini` to switch the default. This env default is used when a tool call omits the `provider` parameter.
+
+## Environment Variables
+
+| Variable                     | Description                                  | Required                                 |
+| ---------------------------- | -------------------------------------------- | ---------------------------------------- |
+| `GEMINI_API_KEY`             | Google API key for Gemini 3 Flash Preview    | Optional (required if using Gemini)      |
+| `MOONSHOT_API_KEY`           | Moonshot AI API key for Kimi K2.5            | Optional (required if using Kimi)        |
+| `Z_AI_API_KEY`               | Z.AI API key for GLM-4.6V                    | Optional (required if using GLM)         |
+| `VIDEO_MCP_DEFAULT_PROVIDER` | Default backend (`gemini`, `glm`, `kimi`)    | Optional (default: `glm`)                |
+| `VIDEO_MCP_MAX_FRAMES`       | Max frames for summarization (GLM/Kimi only) | Optional (default: 20; clamped to 5-100) |
+
+### Example Configuration
+
+```json
+{
+  "servers": {
+    "videoMcp": {
+      "type": "stdio",
+      "command": "video-context-mcp",
+      "env": {
+        "GEMINI_API_KEY": "your-gemini-key",
+        "Z_AI_API_KEY": "your-zai-key",
+        "MOONSHOT_API_KEY": "your-moonshot-key",
+        "VIDEO_MCP_DEFAULT_PROVIDER": "glm"
+      }
+    }
+  }
+}
+```
+
+> **Note:** `VIDEO_MCP_MAX_FRAMES` only applies when using **GLM or Kimi** as the provider. Gemini uploads the full video natively and ignores this setting. Add it to `env` only if you are running with `VIDEO_MCP_DEFAULT_PROVIDER=gemini`.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development (auto-restart on changes)
+npm run dev
+
+# Build for production
+npm run build
+
+# Run type checking
+npm run type-check
+
+# Run linter
+npm run lint
+
+# Run automated tests
+npm run test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Run tests with coverage
+npm run test:coverage
+
+# Format all files
+npm run format
+
+# Check formatting only
+npm run format:check
+
+# Lint + Type-check + Format + Build
+npm run ltfb
+```
+
+## Architecture
+
+```
+video-mcp/
+├── src/
+│   ├── index.ts              # MCP server entry point
+│   ├── tools/                # MCP tool implementations
+│   ├── services/             # Backend clients (Kimi, GLM, ffmpeg)
+│   └── utils/                # Helpers (temp files, base64)
+├── .vscode/
+│   └── mcp.json              # VS Code MCP configuration
+├── docs/
+│   └── technical/            # Technical documentation
+└── .github/
+    └── copilot-instructions.md  # Copilot AI assistant guidelines
+```
+
+## License
+
+MIT
+
+## Credits
+
+- [MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk) by Anthropic
+- [Kimi K2.5](https://github.com/MoonshotAI/Kimi-K2.5) by Moonshot AI
+- [GLM-4.6V](https://docs.z.ai/guides/vlm/glm-4.6v) by Z.AI
+- [ffmpeg](https://ffmpeg.org/) for video processing

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,125 @@
+#!/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 tool handlers
+import { analyzeVideoTool } from './tools/analyzeVideo.js';
+import { summarizeVideoTool } from './tools/summarizeVideo.js';
+import { extractFramesTool } from './tools/extractFrames.js';
+import { searchTimestampTool } from './tools/searchTimestamp.js';
+import { getVideoInfoTool } from './tools/getVideoInfo.js';
+import { setLoggerServer } from './utils/logger.js';
+/**
+ * Main entry point for the Video Context MCP Server
+ * Creates an MCP server, registers all video analysis tools, and connects via stdio
+ */
+async function main() {
+    // Create MCP server with name and version
+    const server = new McpServer({
+        name: 'video-mcp',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            logging: {}, // Enable logging for progress reporting
+        },
+    });
+    // Wire up the logger so tools can emit progress notifications
+    setLoggerServer(server);
+    // Register all video analysis tools
+    // Tool 1: analyze_video - Ask questions about video content
+    server.registerTool('analyze_video', {
+        title: 'Analyze Video',
+        description: 'Ask questions about video content and get AI-powered answers. Supports both local files and URLs.',
+        inputSchema: z.object({
+            videoPath: z
+                .string()
+                .describe('Path to the video file (local path or URL)'),
+            question: z
+                .string()
+                .describe('Question to ask about the video content'),
+            provider: z
+                .enum(['glm', 'kimi', 'gemini'])
+                .optional()
+                .describe("AI backend to use: 'glm' (GLM-4.6V, default), 'kimi' (Kimi K2.5), or 'gemini' (Gemini 3 Flash Preview)"),
+        }),
+    }, analyzeVideoTool);
+    // Tool 2: summarize_video - Generate structured video summary
+    server.registerTool('summarize_video', {
+        title: 'Summarize Video',
+        description: 'Generate a structured summary of the video including overview, key scenes, and timeline. For long videos (>5 min), extracts keyframes to reduce token usage (unless using Gemini, which processes natively).',
+        inputSchema: z.object({
+            videoPath: z
+                .string()
+                .describe('Path to the video file (local path or URL)'),
+            provider: z
+                .enum(['glm', 'kimi', 'gemini'])
+                .optional()
+                .describe("AI backend to use: 'glm' (GLM-4.6V, default), 'kimi' (Kimi K2.5), or 'gemini' (Gemini 3 Flash Preview)"),
+        }),
+    }, summarizeVideoTool);
+    // Tool 3: extract_frames - Extract frames from video
+    server.registerTool('extract_frames', {
+        title: 'Extract Frames',
+        description: 'Extract frames from a video at specific timestamps or intervals. Supports local files (including file:// URIs) and remote http(s) URLs. No AI backend required.',
+        inputSchema: z.object({
+            videoPath: z
+                .string()
+                .describe('Path to the video file (local path, file:// URI, or http(s) URL)'),
+            mode: z
+                .enum(['even', 'interval', 'timestamps'])
+                .describe("Extraction mode: 'even' (N evenly-spaced frames), 'interval' (every N seconds), or 'timestamps' (at specific times)"),
+            count: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Number of frames to extract (required for 'even' mode)"),
+            intervalSec: z
+                .number()
+                .min(0.1)
+                .optional()
+                .describe("Interval in seconds between frames (required for 'interval' mode)"),
+            timestamps: z
+                .array(z.number().min(0))
+                .optional()
+                .describe("Array of timestamps in seconds (required for 'timestamps' mode)"),
+        }),
+    }, extractFramesTool);
+    // Tool 4: search_timestamp - Find when something happens in video
+    server.registerTool('search_timestamp', {
+        title: 'Search Timestamp',
+        description: 'Find the timestamp when something specific happens in a video. Extracts frames and uses AI to locate the content. Supports local files (including file:// URIs) and remote http(s) URLs.',
+        inputSchema: z.object({
+            videoPath: z
+                .string()
+                .describe('Path to the video file (local path, file:// URI, or http(s) URL)'),
+            query: z
+                .string()
+                .describe("What to search for, e.g., 'person waves', 'dog runs', 'car crash'"),
+            provider: z
+                .enum(['glm', 'kimi', 'gemini'])
+                .optional()
+                .describe("AI backend to use: 'glm' (GLM-4.6V, default), 'kimi' (Kimi K2.5), or 'gemini' (Gemini 3 Flash Preview)"),
+        }),
+    }, searchTimestampTool);
+    // Tool 5: get_video_info - Get video metadata
+    server.registerTool('get_video_info', {
+        title: 'Get Video Info',
+        description: 'Get video metadata including duration, resolution, fps, codec, file size, and format. Supports local files (including file:// URIs) and remote http(s) URLs. No AI backend required.',
+        inputSchema: z.object({
+            videoPath: z
+                .string()
+                .describe('Path to the video file (local path, file:// URI, or http(s) URL)'),
+        }),
+    }, getVideoInfoTool);
+    // Connect to VS Code via stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Server is now running, listening for tool calls from Copilot
+}
+main().catch((error) => {
+    console.error('Fatal error starting video-mcp server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/services/ffmpeg.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Video Metadata
+ */
+export interface VideoMetadata {
+    duration: number;
+    width: number;
+    height: number;
+    fps: number;
+    codec: string;
+    fileSize: number;
+    format: string;
+}
+/**
+ * Get video metadata using ffprobe
+ * @param videoPath - Path to the video file
+ * @returns Video metadata
+ */
+export declare function getVideoMetadata(videoPath: string): Promise<VideoMetadata>;
+/**
+ * Extract a single frame at a specific timestamp
+ * @param videoPath - Path to the video file
+ * @param timestampSec - Timestamp in seconds
+ * @returns Buffer containing the PNG frame
+ */
+export declare function extractFrameAt(videoPath: string, timestampSec: number): Promise<Buffer>;
+/**
+ * Extract N evenly-spaced frames from a video
+ * @param videoPath - Path to the video file
+ * @param count - Number of frames to extract
+ * @returns Array of PNG buffers
+ */
+export declare function extractFramesEvenly(videoPath: string, count: number): Promise<Buffer[]>;
+/**
+ * Extract frames at regular intervals
+ * @param videoPath - Path to the video file
+ * @param intervalSec - Interval in seconds between frames
+ * @returns Array of PNG buffers
+ */
+export declare function extractFramesAtInterval(videoPath: string, intervalSec: number): Promise<Buffer[]>;
+/**
+ * Extract frames at specific timestamps
+ * @param videoPath - Path to the video file
+ * @param timestamps - Array of timestamps in seconds
+ * @returns Array of PNG buffers (same order as timestamps)
+ */
+export declare function extractFramesAtTimestamps(videoPath: string, timestamps: number[]): Promise<Buffer[]>;
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/services/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../../src/services/ffmpeg.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CA0BxB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBnB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BnB"}