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 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-Backend Support** β€” Choose between GLM-4.6V, Kimi K2.5, or Gemini
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 Backends
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 backend:
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 backend |
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
- ## Backend Comparison
246
+ ## Provider Comparison
245
247
 
246
- ### Video Backends
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 | Default |
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 backend: `glm`, `kimi`, or `gemini` | `glm` |
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.34.1-beta";
1
+ export declare const VERSION = "0.35.0-beta";
2
2
  //# sourceMappingURL=version.d.ts.map
@@ -1,3 +1,3 @@
1
1
  // Auto-generated by scripts/sync-version.ts β€” do not edit
2
- export const VERSION = '0.34.1-beta';
2
+ export const VERSION = '0.35.0-beta';
3
3
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,11 +1,12 @@
1
1
  {
2
2
  "name": "video-context-mcp-server",
3
- "version": "0.34.1-beta",
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",