mcp-youtube-intelligence 0.2.5 → 0.2.6

package/README.md

@@ -33,6 +33,16 @@ You need API keys for three services:
 npm install -g mcp-youtube-intelligence
 ```
 
+## CLI flags
+
+```bash
+mcp-youtube-intelligence --version   # or -v — print the installed version and exit
+mcp-youtube-intelligence --help      # or -h — print usage and exit
+```
+
+Running the command with no flags starts the MCP server itself (stdio transport) — this is what
+an MCP client config invokes; it's not meant to be run bare in a terminal for interactive use.
+
 ## Usage
 
 Add to your Claude Desktop / MCP client config:

package/build/analyze_channel.js

@@ -97,6 +97,9 @@ export function getGeminiApiKey() {
 // ---------------------------------------------------------------------------
 export function parseChannelInput(input) {
     const trimmed = input.trim();
+    if (!trimmed) {
+        throw new Error("channel_url must not be empty.");
+    }
     // Bare @handle — e.g. @fireship or @web.dev (periods allowed in handles)
     if (/^@[\w.-]+$/.test(trimmed))
         return { type: "handle", value: trimmed };

package/build/cli.js

@@ -0,0 +1,30 @@
+/**
+ * Pure argv → output-text mapping for the --version/--help flags, split out of
+ * index.ts so it can be unit tested without importing index.ts itself — that
+ * module connects a stdio MCP transport as a top-level side effect on import,
+ * which would hang a test runner.
+ */
+const HELP_TEXT = (version) => `mcp-youtube-intelligence v${version} — MCP server for YouTube channel intelligence
+
+Usage:
+  mcp-youtube-intelligence [options]
+
+Options:
+  --help, -h      Show this help message
+  --version, -v   Print the installed version
+
+Tools provided:
+  analyze_channel   Extract transcripts, topics, and competitive signals from a YouTube channel`;
+/**
+ * Returns the text to print for --version/-v or --help/-h, or null if argv
+ * contains neither (the normal MCP-server-startup path). --version/-v takes
+ * precedence when both are present.
+ */
+export function getCliOutput(argv, version) {
+    if (argv.includes("--version") || argv.includes("-v"))
+        return version;
+    if (argv.includes("--help") || argv.includes("-h"))
+        return HELP_TEXT(version);
+    return null;
+}
+//# sourceMappingURL=cli.js.map

package/build/index.js

@@ -11,24 +11,12 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { analyzeChannel } from "./analyze_channel.js";
+import { getCliOutput } from "./cli.js";
 const require = createRequire(import.meta.url);
 const { version: packageVersion } = require("../package.json");
-if (process.argv.includes("--version") || process.argv.includes("-v")) {
-    console.log(packageVersion);
-    process.exit(0);
-}
-if (process.argv.includes("--help") || process.argv.includes("-h")) {
-    console.log(`mcp-youtube-intelligence v${packageVersion} — MCP server for YouTube channel intelligence
-
-Usage:
-  mcp-youtube-intelligence [options]
-
-Options:
-  --help, -h      Show this help message
-  --version, -v   Print the installed version
-
-Tools provided:
-  analyze_channel   Extract transcripts, topics, and competitive signals from a YouTube channel`);
+const cliOutput = getCliOutput(process.argv, packageVersion);
+if (cliOutput !== null) {
+    console.log(cliOutput);
     process.exit(0);
 }
 const server = new McpServer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-youtube-intelligence",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "MCP server for extracting structured intelligence from YouTube channels and videos — transcripts, topics, competitive signals",
   "mcpName": "io.github.dmitriusan/mcp-youtube-intelligence",
   "main": "build/index.js",