video-context-mcp-server 0.23.1-beta → 0.23.3-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.
Files changed (4) hide show
  1. package/README.md +20 -18
  2. package/dist/generated/version.d.ts +1 -1
  3. package/dist/generated/version.js +1 -1
  4. package/package.json +1 -1
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 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 (free), Kimi K2.5, or Gemini
17
+ - 🔄 **Multi-Backend Support** — Choose between GLM-4.6V, Kimi K2.5, or Gemini (free tiers available)
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
 
@@ -101,13 +101,14 @@ Add to your Cursor MCP configuration (global or project-level):
101
101
  <summary><strong>Claude Code</strong></summary>
102
102
 
103
103
  ```bash
104
- claude mcp add videoMcp video-context-mcp \
104
+ claude mcp add \
105
105
  --env Z_AI_API_KEY=your-zai-key \
106
106
  --env MOONSHOT_API_KEY=your-moonshot-key \
107
107
  --env GEMINI_API_KEY=your-gemini-key \
108
108
  --env DEEPGRAM_API_KEY=your-deepgram-key \
109
109
  --env ASSEMBLYAI_API_KEY=your-assemblyai-key \
110
- --env GROQ_API_KEY=your-groq-key
110
+ --env GROQ_API_KEY=your-groq-key \
111
+ videoMcp -- video-context-mcp
111
112
  ```
112
113
 
113
114
  Verify with `claude mcp list`.
@@ -144,13 +145,14 @@ Use `npx -y video-context-mcp-server@latest` as the command instead of `video-co
144
145
  **Claude Code:**
145
146
 
146
147
  ```bash
147
- claude mcp add videoMcp npx -y video-context-mcp-server@latest \
148
+ claude mcp add \
148
149
  --env Z_AI_API_KEY=your-zai-key \
149
150
  --env MOONSHOT_API_KEY=your-moonshot-key \
150
151
  --env GEMINI_API_KEY=your-gemini-key \
151
152
  --env DEEPGRAM_API_KEY=your-deepgram-key \
152
153
  --env ASSEMBLYAI_API_KEY=your-assemblyai-key \
153
- --env GROQ_API_KEY=your-groq-key
154
+ --env GROQ_API_KEY=your-groq-key \
155
+ videoMcp -- npx -y video-context-mcp-server@latest
154
156
  ```
155
157
 
156
158
  </details>
@@ -210,11 +212,11 @@ All tools accept local file paths, `file://` URIs, and remote `http(s)` URLs. Re
210
212
 
211
213
  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:
212
214
 
213
- | Provider | Key | Link |
214
- | ---------------------------- | ------------------ | ------------------------------------------------- |
215
- | **GLM-4.6V** (default, free) | `Z_AI_API_KEY` | [Get key](https://z.ai/manage-apikey/apikey-list) |
216
- | **Kimi K2.5** | `MOONSHOT_API_KEY` | [Get key](https://platform.moonshot.ai) |
217
- | **Gemini 3 Flash Preview** | `GEMINI_API_KEY` | [Get key](https://aistudio.google.com/app/apikey) |
215
+ | Provider | Key | Link |
216
+ | -------------------------------------- | ------------------ | ------------------------------------------------- |
217
+ | **GLM-4.6V** (default, free-tier) | `Z_AI_API_KEY` | [Get key](https://z.ai/manage-apikey/apikey-list) |
218
+ | **Kimi K2.5** | `MOONSHOT_API_KEY` | [Get key](https://platform.moonshot.ai) |
219
+ | **Gemini 3 Flash Preview** (free-tier) | `GEMINI_API_KEY` | [Get key](https://aistudio.google.com/app/apikey) |
218
220
 
219
221
  When a provider's API key is missing or its API call fails at runtime, tools automatically fall back through the remaining providers in priority order, starting from the configured default:
220
222
 
@@ -226,12 +228,12 @@ When a provider's API key is missing or its API call fails at runtime, tools aut
226
228
 
227
229
  Similarly, set all audio keys so transcription always has a fallback provider available:
228
230
 
229
- | Provider | Key | Link |
230
- | ----------------------- | -------------------- | ----------------------------------------------- |
231
- | **Deepgram** (default) | `DEEPGRAM_API_KEY` | [Get key](https://console.deepgram.com/) |
232
- | **AssemblyAI** | `ASSEMBLYAI_API_KEY` | [Get key](https://www.assemblyai.com/dashboard) |
233
- | **Groq/Whisper** (free) | `GROQ_API_KEY` | [Get key](https://console.groq.com/) |
234
- | **Gemini** | `GEMINI_API_KEY` | Reuses the same key as the video backend |
231
+ | Provider | Key | Link |
232
+ | ----------------------------------------- | -------------------- | ----------------------------------------------- |
233
+ | **Deepgram** (default, $200 free credits) | `DEEPGRAM_API_KEY` | [Get key](https://console.deepgram.com/) |
234
+ | **AssemblyAI** ($50 free credits) | `ASSEMBLYAI_API_KEY` | [Get key](https://www.assemblyai.com/dashboard) |
235
+ | **Groq/Whisper** (free-tier) | `GROQ_API_KEY` | [Get key](https://console.groq.com/) |
236
+ | **Gemini** (free-tier) | `GEMINI_API_KEY` | Reuses the same key as the video backend |
235
237
 
236
238
  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**).
237
239
 
@@ -249,7 +251,7 @@ When an audio key is missing or an audio API call fails at runtime, tools automa
249
251
  | Max file size | ~20 MB (base64) | 100 MB | 2 GB |
250
252
  | Best for | **Default** — free, good accuracy | Broader format support | Last-resort fallback only |
251
253
 
252
- **GLM-4.6V** is the default — it offers a free tier, making it a good zero-cost starting point. **Kimi K2.5** is a paid alternative with broader format support. **Gemini** is used as a last-resort fallback — despite superior technical specs, it has proven inaccurate for video analysis in practice.
254
+ **GLM-4.6V** is the default — it offers a free tier, making it a good zero-cost starting point. **Kimi K2.5** is a paid alternative with broader format support. **Gemini** is also free and used as a last-resort fallback — despite superior technical specs, it has proven inaccurate for video analysis in practice.
253
255
 
254
256
  Set `VIDEO_MCP_DEFAULT_PROVIDER=kimi` or `gemini` to change the default.
255
257
 
@@ -257,7 +259,7 @@ Set `VIDEO_MCP_DEFAULT_PROVIDER=kimi` or `gemini` to change the default.
257
259
 
258
260
  | Feature | Deepgram (default) | AssemblyAI | Groq/Whisper | Gemini |
259
261
  | ------------------- | ---------------------------- | ------------------------ | ----------------------- | -------------------------- |
260
- | Price | Paid (free trial) | Paid (free trial) | Free tier available | Free tier available |
262
+ | Price | Paid ($200 free credits) | Paid ($50 free credits) | Free tier available | Free tier available |
261
263
  | Speaker diarization | Yes | Yes | No | No |
262
264
  | Translation | No | No | Yes (`translate: true`) | Yes (`translate: true`) |
263
265
  | Best for | **Default** (fast, accurate) | High-quality diarization | Free/cost-conscious use | Users already using Gemini |
package/dist/generated/version.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.23.1-beta";
1
+ export declare const VERSION = "0.23.3-beta";
2
2
  //# sourceMappingURL=version.d.ts.map
package/dist/generated/version.js CHANGED
@@ -1,3 +1,3 @@
1
1
  // Auto-generated by scripts/sync-version.ts — do not edit
2
- export const VERSION = '0.23.1-beta';
2
+ export const VERSION = '0.23.3-beta';
3
3
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "video-context-mcp-server",
3
- "version": "0.23.1-beta",
3
+ "version": "0.23.3-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",