video-context-mcp-server 0.34.1-beta β 0.35.0-beta
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 +20 -14
- package/dist/generated/version.d.ts +1 -1
- package/dist/generated/version.js +1 -1
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -14,7 +14,7 @@ An MCP server that gives coding assistants (GitHub Copilot, Cursor, Claude Code)
|
|
|
14
14
|
- ποΈ **Audio Transcription** β Transcribe speech with paragraph-level timestamps (`[MM:SS]`) using Deepgram, AssemblyAI, Groq/Whisper, or Gemini
|
|
15
15
|
- π **Speaker Diarization** β Identify who said what (Deepgram and AssemblyAI)
|
|
16
16
|
- π **Audio-Enhanced Analysis** β Auto-transcribes audio and injects transcripts into AI prompts for richer results (GLM/Kimi only)
|
|
17
|
-
- π **Multi-
|
|
17
|
+
- π **Multi-Provider Support** β Choose between GLM-4.6V, Kimi K2.5, or Gemini
|
|
18
18
|
- π― **Smart Video Handling** β Extracts keyframes from long videos to reduce token usage
|
|
19
19
|
- β **Pro tier** β Extended frame extraction, multi-platform downloads, higher resolution. [Learn more β](#pro)
|
|
20
20
|
|
|
@@ -34,6 +34,8 @@ An MCP server that gives coding assistants (GitHub Copilot, Cursor, Claude Code)
|
|
|
34
34
|
npm install -g video-context-mcp-server
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
+
After install, two equivalent CLI commands are available: `video-context-mcp` (full name) and `vmcp` (short alias). Use whichever you prefer β they are identical.
|
|
38
|
+
|
|
37
39
|
### Updating & version check
|
|
38
40
|
|
|
39
41
|
```bash
|
|
@@ -210,9 +212,9 @@ All tools accept local file paths, `file://` URIs, and remote `http(s)` URLs. Re
|
|
|
210
212
|
|
|
211
213
|
## API Keys
|
|
212
214
|
|
|
213
|
-
### Video
|
|
215
|
+
### Video Providers
|
|
214
216
|
|
|
215
|
-
Set all three keys to get the full fallback chain. The server will try GLM first, then Kimi, then Gemini, so having all keys ensures it never gets stuck without a working
|
|
217
|
+
Set all three keys to get the full fallback chain. The server will try GLM first, then Kimi, then Gemini, so having all keys ensures it never gets stuck without a working provider:
|
|
216
218
|
|
|
217
219
|
| Provider | Key | Link |
|
|
218
220
|
| -------------------------------------- | ------------------ | ------------------------------------------------- |
|
|
@@ -235,15 +237,15 @@ Similarly, set all audio keys so transcription always has a fallback provider av
|
|
|
235
237
|
| **Deepgram** (default, $200 free credits) | `DEEPGRAM_API_KEY` | [Get key](https://console.deepgram.com/) |
|
|
236
238
|
| **AssemblyAI** ($50 free credits) | `ASSEMBLYAI_API_KEY` | [Get key](https://www.assemblyai.com/dashboard) |
|
|
237
239
|
| **Groq/Whisper** (free-tier) | `GROQ_API_KEY` | [Get key](https://console.groq.com/) |
|
|
238
|
-
| **Gemini** (free-tier) | `GEMINI_API_KEY` | Reuses the same key as the video
|
|
240
|
+
| **Gemini** (free-tier) | `GEMINI_API_KEY` | Reuses the same key as the video provider |
|
|
239
241
|
|
|
240
242
|
When an audio key is missing or an audio API call fails at runtime, tools automatically fall back through the remaining providers in priority order, starting from the configured default (e.g. with Deepgram default: **Deepgram β AssemblyAI β Groq β Gemini**).
|
|
241
243
|
|
|
242
244
|
---
|
|
243
245
|
|
|
244
|
-
##
|
|
246
|
+
## Provider Comparison
|
|
245
247
|
|
|
246
|
-
### Video
|
|
248
|
+
### Video Providers
|
|
247
249
|
|
|
248
250
|
| Feature | GLM-4.6V (default) | Kimi K2.5 | Gemini 3 Flash Preview |
|
|
249
251
|
| -------------- | ------------------------------------ | ---------------------------------------------- | ---------------------------------------------- |
|
|
@@ -276,12 +278,12 @@ Set `AUDIO_MCP_DEFAULT_PROVIDER` to change the default.
|
|
|
276
278
|
|
|
277
279
|
### Core
|
|
278
280
|
|
|
279
|
-
| Variable | Description
|
|
280
|
-
| ---------------------------- |
|
|
281
|
-
| `Z_AI_API_KEY` | Z.AI API key for GLM-4.6V
|
|
282
|
-
| `MOONSHOT_API_KEY` | Moonshot AI API key for Kimi K2.5
|
|
283
|
-
| `GEMINI_API_KEY` | Google API key for Gemini
|
|
284
|
-
| `VIDEO_MCP_DEFAULT_PROVIDER` | Default video
|
|
281
|
+
| Variable | Description | Default |
|
|
282
|
+
| ---------------------------- | -------------------------------------------------- | ------- |
|
|
283
|
+
| `Z_AI_API_KEY` | Z.AI API key for GLM-4.6V | β |
|
|
284
|
+
| `MOONSHOT_API_KEY` | Moonshot AI API key for Kimi K2.5 | β |
|
|
285
|
+
| `GEMINI_API_KEY` | Google API key for Gemini | β |
|
|
286
|
+
| `VIDEO_MCP_DEFAULT_PROVIDER` | Default video provider: `glm`, `kimi`, or `gemini` | `glm` |
|
|
285
287
|
|
|
286
288
|
### Audio
|
|
287
289
|
|
|
@@ -321,7 +323,7 @@ The server automatically manages the cache by:
|
|
|
321
323
|
|
|
322
324
|
#### Cache Management CLI
|
|
323
325
|
|
|
324
|
-
`video-context-mcp` ships with built-in cache management commands. Run them from any terminal β they complete immediately and do **not** start the MCP server.
|
|
326
|
+
`video-context-mcp` (or the short alias `vmcp`) ships with built-in cache management commands. Run them from any terminal β they complete immediately and do **not** start the MCP server.
|
|
325
327
|
|
|
326
328
|
```bash
|
|
327
329
|
# Show cache location, size, entry count, TTL, and per-entry breakdown
|
|
@@ -479,6 +481,10 @@ When a free-tier limit is reached, the tool falls back gracefully with a notice
|
|
|
479
481
|
|
|
480
482
|
License keys are valid for **1 year**.
|
|
481
483
|
|
|
484
|
+
π LAUNCH PROMO: Get PRO for Free!
|
|
485
|
+
|
|
486
|
+
For a limited time, you can get a PRO license for free. Just enter 0 in the amount field. If you'd like to support the development, feel free to enter any amount you chooseβany contribution is greatly appreciated!
|
|
487
|
+
|
|
482
488
|
**[Purchase a Pro License on Gumroad](https://jeromekph.gumroad.com/l/video-context-mcp)**
|
|
483
489
|
|
|
484
490
|
Add `VIDEO_MCP_LICENSE_KEY` to your MCP config `env` block and restart the server:
|
|
@@ -495,7 +501,7 @@ Add `VIDEO_MCP_LICENSE_KEY` to your MCP config `env` block and restart the serve
|
|
|
495
501
|
|
|
496
502
|
## Troubleshooting
|
|
497
503
|
|
|
498
|
-
- **`video-context-mcp: command not found`** β Make sure Node.js is installed (`node -v`). Re-run `npm install -g video-context-mcp-server`, or use `npx -y video-context-mcp-server@latest` if global binaries aren't on PATH.
|
|
504
|
+
- **`video-context-mcp: command not found`** (or `vmcp: command not found`) β Make sure Node.js is installed (`node -v`). Re-run `npm install -g video-context-mcp-server`, or use `npx -y video-context-mcp-server@latest` if global binaries aren't on PATH.
|
|
499
505
|
|
|
500
506
|
- **MCP server not appearing** β Restart the client app after config changes. Validate JSON syntax. For Claude Code, verify with `claude mcp list`.
|
|
501
507
|
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare const VERSION = "0.
|
|
1
|
+
export declare const VERSION = "0.35.0-beta";
|
|
2
2
|
//# sourceMappingURL=version.d.ts.map
|
package/package.json
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "video-context-mcp-server",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.35.0-beta",
|
|
4
4
|
"description": "A Model Context Protocol server that gives GitHub Copilot the ability to understand and analyze video content",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"bin": {
|
|
8
|
-
"video-context-mcp": "dist/index.js"
|
|
8
|
+
"video-context-mcp": "dist/index.js",
|
|
9
|
+
"vmcp": "dist/index.js"
|
|
9
10
|
},
|
|
10
11
|
"scripts": {
|
|
11
12
|
"dev": "tsx watch src/index.ts",
|