mcp-video-analyzer 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +53 -4
- package/package.json +10 -10
package/README.md
CHANGED
|
@@ -4,14 +4,51 @@ MCP server for video analysis — extracts transcripts, key frames, and metadata
|
|
|
4
4
|
|
|
5
5
|
No existing video MCP combines **transcripts + visual frames + metadata** in one tool. This one does.
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Installation
|
|
8
|
+
|
|
9
|
+
### Prerequisites
|
|
10
|
+
|
|
11
|
+
- **Node.js 18+** — required to run the server via `npx`
|
|
12
|
+
- **yt-dlp** (optional) — enables frame extraction via ffmpeg. Install with `pip install yt-dlp`
|
|
13
|
+
- **Chrome/Chromium** (optional) — fallback for frame extraction if yt-dlp is unavailable
|
|
14
|
+
|
|
15
|
+
> Without yt-dlp or Chrome, the server still works — you'll get transcripts, metadata, and comments, just no frames.
|
|
16
|
+
|
|
17
|
+
### Claude Code (CLI)
|
|
8
18
|
|
|
9
19
|
```bash
|
|
10
|
-
|
|
11
|
-
claude mcp add video-analyzer npx mcp-video-analyzer@latest
|
|
20
|
+
claude mcp add video-analyzer -- npx mcp-video-analyzer@latest
|
|
12
21
|
```
|
|
13
22
|
|
|
14
|
-
|
|
23
|
+
Then restart Claude Code or start a new conversation.
|
|
24
|
+
|
|
25
|
+
### VS Code / Cursor
|
|
26
|
+
|
|
27
|
+
Add to your MCP settings file:
|
|
28
|
+
|
|
29
|
+
- **VS Code**: `File → Preferences → Settings → search "MCP"` or edit `~/.vscode/mcp.json` / `%APPDATA%\Code\User\mcp.json` (Windows)
|
|
30
|
+
- **Cursor**: `Settings → MCP Servers → Add`
|
|
31
|
+
|
|
32
|
+
```json
|
|
33
|
+
{
|
|
34
|
+
"servers": {
|
|
35
|
+
"mcp-video-analyzer": {
|
|
36
|
+
"type": "stdio",
|
|
37
|
+
"command": "npx",
|
|
38
|
+
"args": ["mcp-video-analyzer@latest"]
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Then reload the window (`Ctrl+Shift+P` → "Developer: Reload Window").
|
|
45
|
+
|
|
46
|
+
### Claude Desktop
|
|
47
|
+
|
|
48
|
+
Add to your Claude Desktop config file:
|
|
49
|
+
|
|
50
|
+
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
51
|
+
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
15
52
|
|
|
16
53
|
```json
|
|
17
54
|
{
|
|
@@ -24,6 +61,18 @@ Or manually add to your MCP config (Claude Desktop, Cursor, VS Code):
|
|
|
24
61
|
}
|
|
25
62
|
```
|
|
26
63
|
|
|
64
|
+
Then restart Claude Desktop.
|
|
65
|
+
|
|
66
|
+
### Verify it works
|
|
67
|
+
|
|
68
|
+
Once installed, ask your AI assistant:
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
Analyze this video: https://www.loom.com/share/bdebdfe44b294225ac718bad241a94fe
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
If the server is connected, it will automatically call the `analyze_video` tool.
|
|
75
|
+
|
|
27
76
|
## Tools
|
|
28
77
|
|
|
29
78
|
### `analyze_video` — Full video analysis
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-video-analyzer",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "MCP server for video analysis — extracts transcripts, key frames, OCR text, and metadata from video URLs. Supports Loom and direct video files.",
|
|
5
5
|
"author": "guimatheus92",
|
|
6
6
|
"license": "MIT",
|
|
@@ -56,23 +56,23 @@
|
|
|
56
56
|
"node": ">=18"
|
|
57
57
|
},
|
|
58
58
|
"dependencies": {
|
|
59
|
-
"cheerio": "^1.
|
|
60
|
-
"fastmcp": "^
|
|
61
|
-
"ffmpeg-static": "^5.
|
|
62
|
-
"puppeteer-core": "^24.
|
|
63
|
-
"sharp": "^0.
|
|
59
|
+
"cheerio": "^1.2.0",
|
|
60
|
+
"fastmcp": "^3.34.0",
|
|
61
|
+
"ffmpeg-static": "^5.3.0",
|
|
62
|
+
"puppeteer-core": "^24.39.0",
|
|
63
|
+
"sharp": "^0.34.5",
|
|
64
64
|
"tesseract.js": "^7.0.0",
|
|
65
|
-
"zod": "^3.
|
|
65
|
+
"zod": "^4.3.6"
|
|
66
66
|
},
|
|
67
67
|
"devDependencies": {
|
|
68
68
|
"@eslint/js": "^10.0.1",
|
|
69
|
-
"@types/node": "^
|
|
69
|
+
"@types/node": "^25.4.0",
|
|
70
70
|
"@vitest/coverage-v8": "^4.0.18",
|
|
71
71
|
"eslint": "^10.0.3",
|
|
72
72
|
"knip": "^5.86.0",
|
|
73
73
|
"prettier": "^3.8.1",
|
|
74
|
-
"typescript": "^5.
|
|
75
|
-
"typescript-eslint": "^8.
|
|
74
|
+
"typescript": "^5.9.3",
|
|
75
|
+
"typescript-eslint": "^8.57.0",
|
|
76
76
|
"vitest": "^4.0.18"
|
|
77
77
|
}
|
|
78
78
|
}
|