youtube-knowledge-mcp 2.1.0 → 2.2.0

package/dist/index.js

@@ -1,43 +1,12 @@
-import { readFileSync } from 'fs';
-import { dirname, join } from 'path';
-import { z } from 'zod';
-import { fileURLToPath } from 'url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { fetchVideosSchema, fetchVideosOutputSchema, fetchVideosHandler, } from './tools/fetch-videos.js';
-import { getVideoInfoSchema, getVideoInfoOutputSchema, getVideoInfoHandler, } from './tools/get-video-info.js';
-import { getTranscriptSchema, getTranscriptOutputSchema, getTranscriptHandler, } from './tools/get-transcript.js';
-import { searchVideosSchema, searchVideosOutputSchema, searchVideosHandler, } from './tools/search-videos.js';
-import { getChaptersSchema, getChaptersOutputSchema, getChaptersHandler, } from './tools/get-chapters.js';
-import { getCommentsSchema, getCommentsOutputSchema, getCommentsHandler, } from './tools/get-comments.js';
-import { getChannelInfoSchema, getChannelInfoOutputSchema, getChannelInfoHandler, } from './tools/get-channel-info.js';
-import { searchChannelsSchema, searchChannelsOutputSchema, searchChannelsHandler, } from './tools/search-channels.js';
-import { getPlaylistInfoSchema, getPlaylistInfoOutputSchema, getPlaylistInfoHandler, } from './tools/get-playlist-info.js';
-import { saveToLibrarySchema, saveToLibraryOutputSchema, saveToLibraryHandler, } from './tools/save-to-library.js';
-import { listLibrarySchema, listLibraryOutputSchema, listLibraryHandler, } from './tools/list-library.js';
-import { listFormatsSchema, listFormatsOutputSchema, listFormatsHandler, downloadVideoSchema, downloadVideoOutputSchema, downloadVideoHandler, } from './tools/download-video.js';
-import { checkHealthSchema, checkHealthOutputSchema, checkHealthHandler, } from './tools/check-health.js';
-import { searchTranscriptSchema, searchTranscriptOutputSchema, searchTranscriptHandler, } from './tools/search-transcript.js';
-import { getTranscriptsSchema, getTranscriptsOutputSchema, getTranscriptsHandler, digestPlaylistSchema, digestPlaylistOutputSchema, digestPlaylistHandler, } from './tools/batch.js';
-import { extractClipSchema, extractClipOutputSchema, extractClipHandler, extractAudioClipSchema, extractAudioClipOutputSchema, extractAudioClipHandler, extractClipsSchema, extractClipsOutputSchema, extractClipsHandler, extractFrameSchema, extractFrameOutputSchema, extractFrameHandler, exportSubtitlesSchema, exportSubtitlesOutputSchema, exportSubtitlesHandler, } from './tools/clips.js';
-import { getLibraryItemSchema, getLibraryItemOutputSchema, getLibraryItemHandler, searchLibrarySchema, searchLibraryOutputSchema, searchLibraryHandler, deleteLibraryItemSchema, deleteLibraryItemOutputSchema, deleteLibraryItemHandler, updateLibraryTagsSchema, updateLibraryTagsOutputSchema, updateLibraryTagsHandler, rebuildLibraryIndexSchema, rebuildLibraryIndexOutputSchema, rebuildLibraryIndexHandler, } from './tools/library.js';
-import { buildBrainHandler, buildBrainOutputSchema, buildBrainSchema, } from './tools/build-brain.js';
-import { askBrainHandler, askBrainOutputSchema, askBrainSchema } from './tools/ask-brain.js';
-import { getBrainInfoHandler, getBrainInfoOutputSchema, getBrainInfoSchema, listBrainsHandler, listBrainsOutputSchema, listBrainsSchema, } from './tools/brain-info.js';
-import { deleteBrainHandler, deleteBrainOutputSchema, deleteBrainSchema, saveBrainProfileHandler, saveBrainProfileOutputSchema, saveBrainProfileSchema, } from './tools/manage-brain.js';
-import { runWithRequestContext } from './utils/context.js';
-import { toToolError } from './utils/errors.js';
 import { formatPreflightReport, runPreflight } from './utils/preflight.js';
 import { startHttp } from './http.js';
+import { serverVersion } from './utils/version.js';
+import { describeYtDlpEnv, readYtDlpEnv } from './utils/ytdlp-env.js';
 import { registerPrompts } from './prompts.js';
+import { registerTools } from './registry/index.js';
 import { registerResources } from './resources.js';
-const __dirname = dirname(fileURLToPath(import.meta.url));
-// The version is advertised in the MCP initialize response, so a package.json
-// that has lost it should fail loudly at startup rather than telling every
-// client the server is version `undefined`.
-const pkg = z
-    .object({ version: z.string() })
-    .parse(JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')));
 const SERVER_INSTRUCTIONS = `YouTube Knowledge MCP provides tools to search, analyze, and extract knowledge from YouTube videos.
 
 Recommended workflows:
@@ -45,76 +14,10 @@ Recommended workflows:
 - Use get_chapters to understand video structure before reading the full transcript
 - Use get_comments for audience sentiment and discussion highlights
 - Use get_channel_info to contextualize a creator's content
+- Use get_thumbnail to look at a video's thumbnail or a channel's avatar
 - Combine transcript + chapters for structured, timestamped summaries
 
 All tools accept YouTube video IDs (e.g., dQw4w9WgXcQ) or full URLs.`;
-/**
- * Wrap a tool handler so that every call gets a request context and no call can
- * throw out of the server.
- *
- * Two things happen here, once, instead of thirteen times in thirteen files:
- * the MCP request's AbortSignal is published to the request context so an
- * in-flight yt-dlp is killed when the client cancels, and anything thrown is
- * rendered as an `isError` result carrying an actionable message rather than a
- * raw stack trace or yt-dlp command line.
- */
-/**
- * The parts of the SDK's `RequestHandlerExtra` this server uses.
- *
- * `sendNotification` is described with `z.custom` because a function is not
- * something Zod can take apart structurally — the predicate is a real runtime
- * check, and it is what lets the property be called without asserting a type
- * over it.
- */
-const requestExtraSchema = z.object({
-    signal: z.instanceof(AbortSignal).optional(),
-    sendNotification: z
-        .custom((value) => typeof value === 'function')
-        .optional(),
-    _meta: z.object({ progressToken: z.union([z.string(), z.number()]).optional() }).optional(),
-});
-function guarded(handler) {
-    return async (...args) => {
-        // Handlers declare only their own parameters; the SDK appends
-        // RequestHandlerExtra to every call, so it is whatever arrived last.
-        const parsed = requestExtraSchema.safeParse(args[args.length - 1]);
-        const context = parsed.success ? parsed.data : undefined;
-        const signal = context?.signal;
-        return runWithRequestContext({
-            signal,
-            // Progress is only meaningful when the client asked for it by sending a
-            // token; without one the notification would be dropped anyway.
-            reportProgress: context?.sendNotification && context._meta?.progressToken !== undefined
-                ? (progress, total, message) => {
-                    void context.sendNotification?.({
-                        method: 'notifications/progress',
-                        params: {
-                            progressToken: context._meta?.progressToken,
-                            progress,
-                            ...(total === undefined ? {} : { total }),
-                            ...(message === undefined ? {} : { message }),
-                        },
-                    });
-                }
-                : undefined,
-            log: context?.sendNotification
-                ? (level, message) => {
-                    void context.sendNotification?.({
-                        method: 'notifications/message',
-                        params: { level, logger: 'youtube-knowledge-mcp', data: message },
-                    });
-                }
-                : undefined,
-        }, async () => {
-            try {
-                return await handler(...args);
-            }
-            catch (error) {
-                return toToolError(error);
-            }
-        });
-    };
-}
 /**
  * Build a fully configured server.
  *
@@ -122,422 +25,8 @@ function guarded(handler) {
  * MCP client, rather than only testing handlers in isolation.
  */
 export function createServer(mode = 'stdio') {
-    const server = new McpServer({ name: 'youtube-knowledge-mcp', version: pkg.version }, { instructions: SERVER_INSTRUCTIONS, capabilities: { logging: {} } });
-    // -- Remote-safe tools (registered in all modes) --
-    server.registerTool('search_videos', {
-        title: 'Search YouTube Videos',
-        description: 'Search YouTube for videos by keyword or phrase. Returns video IDs, titles, durations, channels, view counts, and URLs. Results sorted by relevance.',
-        inputSchema: searchVideosSchema,
-        outputSchema: searchVideosOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(searchVideosHandler));
-    server.registerTool('fetch_videos', {
-        title: 'Fetch YouTube Videos',
-        description: 'List videos from a YouTube playlist or channel. Returns video IDs, titles, durations, upload dates, and URLs. Sorted by playlist or channel order.',
-        inputSchema: fetchVideosSchema,
-        outputSchema: fetchVideosOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(fetchVideosHandler));
-    server.registerTool('get_video_info', {
-        title: 'Get YouTube Video Info',
-        description: 'Get detailed metadata for a single YouTube video. Returns title, channel, duration, upload date, view count, like count, comment count, description, tags, and thumbnail URL.',
-        inputSchema: getVideoInfoSchema,
-        outputSchema: getVideoInfoOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(getVideoInfoHandler));
-    server.registerTool('get_transcript', {
-        title: 'Get YouTube Video Transcript',
-        description: 'Extract the full transcript from a YouTube video. Supports auto-generated and manual captions. Returns plain text with word count and detected language. Results are cached locally.',
-        inputSchema: getTranscriptSchema,
-        outputSchema: getTranscriptOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(getTranscriptHandler));
-    server.registerTool('get_chapters', {
-        title: 'Get YouTube Video Chapters',
-        description: 'Extract chapter markers and timestamps from a YouTube video. Returns chapter titles with start and end times. Not all videos have chapters. Returns empty list if none found.',
-        inputSchema: getChaptersSchema,
-        outputSchema: getChaptersOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(getChaptersHandler));
-    server.registerTool('get_comments', {
-        title: 'Get YouTube Video Comments',
-        description: 'Get top comments from a YouTube video sorted by popularity. Returns author, text, like count, and pinned status. Only top-level comments, no replies.',
-        inputSchema: getCommentsSchema,
-        outputSchema: getCommentsOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(getCommentsHandler));
-    server.registerTool('get_channel_info', {
-        title: 'Get YouTube Channel Info',
-        description: 'Get metadata for a YouTube channel. Returns channel name, handle, subscriber count, description, and channel URL.',
-        inputSchema: getChannelInfoSchema,
-        outputSchema: getChannelInfoOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(getChannelInfoHandler));
-    server.registerTool('search_channels', {
-        title: 'Search YouTube Channels',
-        description: 'Search YouTube for channels by keyword or phrase. Returns channel names, handles, subscriber counts, descriptions, and URLs.',
-        inputSchema: searchChannelsSchema,
-        outputSchema: searchChannelsOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(searchChannelsHandler));
-    server.registerTool('get_playlist_info', {
-        title: 'Get YouTube Playlist Info',
-        description: 'Get metadata for a YouTube playlist. Returns title, channel, video count, last updated date, and description.',
-        inputSchema: getPlaylistInfoSchema,
-        outputSchema: getPlaylistInfoOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(getPlaylistInfoHandler));
-    server.registerTool('list_formats', {
-        title: 'List YouTube Video Formats',
-        description: 'List all available download formats for a YouTube video. Returns format IDs, extensions, resolutions, FPS, codecs, and file sizes. Grouped by video+audio, video-only, and audio-only.',
-        inputSchema: listFormatsSchema,
-        outputSchema: listFormatsOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(listFormatsHandler));
-    server.registerTool('search_transcript', {
-        title: 'Search Inside a Transcript',
-        description: 'Find a phrase or pattern inside a video transcript and return each match with its timestamp and a link that opens the video at that moment. Use this instead of reading a whole transcript when you need to locate or cite a specific moment.',
-        inputSchema: searchTranscriptSchema,
-        outputSchema: searchTranscriptOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(searchTranscriptHandler));
-    server.registerTool('get_transcripts', {
-        title: 'Get Transcripts for Several Videos',
-        description: 'Fetch transcripts for up to 25 videos in one call, each capped so the batch cannot flood the context. Videos that have no captions are reported individually rather than failing the whole call.',
-        inputSchema: getTranscriptsSchema,
-        outputSchema: getTranscriptsOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(getTranscriptsHandler));
-    server.registerTool('digest_playlist', {
-        title: 'Digest a Playlist or Channel',
-        description: 'Summarize a playlist or channel in one call: per-video metadata, chapter markers, and optionally transcript word counts. Use this to survey a body of content before deciding what to read in full.',
-        inputSchema: digestPlaylistSchema,
-        outputSchema: digestPlaylistOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, guarded(digestPlaylistHandler));
-    server.registerTool('check_health', {
-        title: 'Check Server Health',
-        description: 'Report whether yt-dlp and ffmpeg are installed, their versions, and whether yt-dlp is stale. Call this first when tools start failing unexpectedly — an outdated yt-dlp is the most common cause.',
-        inputSchema: checkHealthSchema,
-        outputSchema: checkHealthOutputSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    }, guarded(checkHealthHandler));
-    // -- Local-only tools (stdio mode only) --
-    if (mode === 'stdio') {
-        server.registerTool('save_to_library', {
-            title: 'Save to YouTube Knowledge Library',
-            description: 'Save a summary or skill note to the local YouTube knowledge library. Overwrites existing content of the same type for the same video. Returns the saved file path.',
-            inputSchema: saveToLibrarySchema,
-            outputSchema: saveToLibraryOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                // Overwrites an existing note of the same type in place, which is a
-                // destructive update: the previous content is not recoverable.
-                destructiveHint: true,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(saveToLibraryHandler));
-        server.registerTool('list_library', {
-            title: 'List YouTube Knowledge Library',
-            description: 'List all saved items in the local YouTube knowledge library. Returns titles, channels, content types, tags, and save dates. Optionally filter by tag. Sorted by most recently saved.',
-            inputSchema: listLibrarySchema,
-            outputSchema: listLibraryOutputSchema,
-            annotations: {
-                readOnlyHint: true,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(listLibraryHandler));
-        server.registerTool('get_library_item', {
-            title: 'Read a Saved Library Item',
-            description: 'Read back a summary or skill note previously saved with save_to_library. Returns the markdown content plus the saved metadata.',
-            inputSchema: getLibraryItemSchema,
-            outputSchema: getLibraryItemOutputSchema,
-            annotations: {
-                readOnlyHint: true,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(getLibraryItemHandler));
-        server.registerTool('search_library', {
-            title: 'Search the Knowledge Library',
-            description: 'Full-text search across every saved summary and skill note, ranked by relevance. Returns matching excerpts with the video IDs needed to read the full note.',
-            inputSchema: searchLibrarySchema,
-            outputSchema: searchLibraryOutputSchema,
-            annotations: {
-                readOnlyHint: true,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(searchLibraryHandler));
-        server.registerTool('update_library_tags', {
-            title: 'Update Library Tags',
-            description: 'Add, remove or replace the tags on a saved library item. Tags are how list_library filters, so this is the way to reorganize a growing library. The replace parameter discards all existing tags.',
-            inputSchema: updateLibraryTagsSchema,
-            outputSchema: updateLibraryTagsOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                // The replace parameter discards every existing tag.
-                destructiveHint: true,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(updateLibraryTagsHandler));
-        server.registerTool('delete_library_item', {
-            title: 'Delete a Library Item',
-            description: 'Permanently delete a saved summary or skill note, or the entire library entry for a video. This removes files from disk and cannot be undone.',
-            inputSchema: deleteLibraryItemSchema,
-            outputSchema: deleteLibraryItemOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                destructiveHint: true,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(deleteLibraryItemHandler));
-        server.registerTool('rebuild_library_index', {
-            title: 'Rebuild the Library Search Index',
-            description: 'Rebuild the full-text search index from the notes on disk. Use this if search_library results look stale or incomplete, for example after editing files by hand.',
-            inputSchema: rebuildLibraryIndexSchema,
-            outputSchema: rebuildLibraryIndexOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(rebuildLibraryIndexHandler));
-        server.registerTool('extract_clip', {
-            title: 'Extract a Video Clip',
-            description: 'Cut a time range out of a YouTube video without downloading the whole thing. Give start and end, or a chapter name. Pair with search_transcript to find the moment first. Requires ffmpeg.',
-            inputSchema: extractClipSchema,
-            outputSchema: extractClipOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: true,
-            },
-        }, guarded(extractClipHandler));
-        server.registerTool('extract_audio_clip', {
-            title: 'Extract an Audio Clip',
-            description: 'Cut a time range out of a video as audio only, in an editor-friendly format (mp3, m4a, wav, flac, opus). Use for podcast pulls and voice-over sourcing. Requires ffmpeg.',
-            inputSchema: extractAudioClipSchema,
-            outputSchema: extractAudioClipOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: true,
-            },
-        }, guarded(extractAudioClipHandler));
-        server.registerTool('extract_clips', {
-            title: 'Extract Several Clips',
-            description: 'Cut several time ranges out of one video in a single call. A range that fails is reported individually rather than losing the clips that succeeded. Requires ffmpeg.',
-            inputSchema: extractClipsSchema,
-            outputSchema: extractClipsOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: true,
-            },
-        }, guarded(extractClipsHandler));
-        server.registerTool('extract_frame', {
-            title: 'Capture a Frame',
-            description: 'Capture a single still image from a video at a given timestamp, without downloading the file. Use for thumbnails and reference frames. Requires ffmpeg.',
-            inputSchema: extractFrameSchema,
-            outputSchema: extractFrameOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: true,
-            },
-        }, guarded(extractFrameHandler));
-        server.registerTool('export_subtitles', {
-            title: 'Export Subtitles',
-            description: 'Write a video transcript to disk as SRT, WebVTT or plain text, ready to import into a video editor such as Premiere, Resolve or CapCut.',
-            inputSchema: exportSubtitlesSchema,
-            outputSchema: exportSubtitlesOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: true,
-            },
-        }, guarded(exportSubtitlesHandler));
-        server.registerTool('download_video', {
-            title: 'Download YouTube Video',
-            description: 'Download a YouTube video to local disk. Use the quality parameter for automatic format selection with smart fallbacks, or formatId for a specific format from list_formats. Returns the downloaded file path, title, and format details.',
-            inputSchema: downloadVideoSchema,
-            outputSchema: downloadVideoOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                destructiveHint: false,
-                // Writes to a deterministic path and overwrites, exactly like the
-                // extract_* tools; repeating the call leaves the same state.
-                idempotentHint: true,
-                openWorldHint: true,
-            },
-        }, guarded(downloadVideoHandler));
-        // -- Channel brains --
-        //
-        // Local like the library, and for the same reason: a brain is tens of
-        // megabytes of one user's reading, and in HTTP mode any client could fill
-        // the server's disk by naming a channel.
-        server.registerTool('build_brain', {
-            title: 'Build a Channel Brain',
-            description: "Read a channel's videos into a searchable corpus of timestamped passages, so you can later ask what its creator has said about anything. Long-running: several hundred videos is several hundred fetches. Safe to interrupt and call again — it continues where it stopped, and on a finished brain it picks up new uploads. The since and minDurationSeconds filters describe the brain, not just the call: narrowing one discards the passages of the videos it excludes, and widening it reads them again. Ask it questions with ask_brain.",
-            inputSchema: buildBrainSchema,
-            outputSchema: buildBrainOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                // A plain build only adds, but narrowing a filter drops the passages
-                // of videos it excludes, and a client should be able to ask first.
-                destructiveHint: true,
-                // Re-running converges on the same brain rather than duplicating
-                // anything: that is the same code path as resuming.
-                idempotentHint: true,
-                openWorldHint: true,
-            },
-        }, guarded(buildBrainHandler));
-        server.registerTool('ask_brain', {
-            title: 'Ask a Channel Brain',
-            description: 'Search everything a creator has said, across every video in their brain. Returns the passages that match, each with the timestamp and a link that opens the video at that moment, so every claim can be checked. Matches the words as spoken, so phrase the query the way the creator would say it. Requires build_brain first.',
-            inputSchema: askBrainSchema,
-            outputSchema: askBrainOutputSchema,
-            annotations: {
-                readOnlyHint: true,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(askBrainHandler));
-        server.registerTool('list_brains', {
-            title: 'List Channel Brains',
-            description: 'List every channel brain built locally, with how much of each channel is indexed and whether a written profile exists.',
-            inputSchema: listBrainsSchema,
-            outputSchema: listBrainsOutputSchema,
-            annotations: {
-                readOnlyHint: true,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(listBrainsHandler));
-        server.registerTool('get_brain_info', {
-            title: 'Get Channel Brain Details',
-            description: "What a brain actually covers: how many videos were read, how many had no captions, how many are still outstanding, the channel's upload rhythm and speaking rate, and the phrases it repeats across videos. Read this before trusting an answer built from ask_brain.",
-            inputSchema: getBrainInfoSchema,
-            outputSchema: getBrainInfoOutputSchema,
-            annotations: {
-                readOnlyHint: true,
-                destructiveHint: false,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(getBrainInfoHandler));
-        server.registerTool('save_brain_profile', {
-            title: 'Save a Channel Brain Profile',
-            description: 'Store a written account of a creator alongside their brain — voice, recurring arguments, how their thinking has changed. Write it from passages returned by ask_brain and cite them, because this server cannot check a claim it was handed. Overwrites any existing profile for that channel.',
-            inputSchema: saveBrainProfileSchema,
-            outputSchema: saveBrainProfileOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                // Replaces the previous profile in place; the old text is not recoverable.
-                destructiveHint: true,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(saveBrainProfileHandler));
-        server.registerTool('delete_brain', {
-            title: 'Delete a Channel Brain',
-            description: 'Permanently delete a channel brain: its passages, its manifest and its profile. The transcripts it was built from stay cached, so rebuilding is much faster than the first build was.',
-            inputSchema: deleteBrainSchema,
-            outputSchema: deleteBrainOutputSchema,
-            annotations: {
-                readOnlyHint: false,
-                destructiveHint: true,
-                idempotentHint: true,
-                openWorldHint: false,
-            },
-        }, guarded(deleteBrainHandler));
-    }
+    const server = new McpServer({ name: 'youtube-knowledge-mcp', version: serverVersion() }, { instructions: SERVER_INSTRUCTIONS, capabilities: { logging: {} } });
+    registerTools(server, mode);
     registerPrompts(server, mode);
     registerResources(server, mode);
     return server;
@@ -572,6 +61,11 @@ export async function announcePreflight() {
 }
 export async function main() {
     const mode = getTransportMode();
+    // Validated once, here, so a misspelt browser name or an unreadable cookies
+    // file stops the server at boot rather than failing the first tool call.
+    const session = readYtDlpEnv();
+    if (session.cookies !== 'none' || session.proxy)
+        console.error(describeYtDlpEnv(session));
     await announcePreflight();
     if (mode === 'http') {
         startHttp(createServer);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,mBAAmB,GAAG;;;;;;;;;;qEAUyC,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAyB,OAAO;IAC3D,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAC3D,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CACrE,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEhC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC;IACnD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC;IACrD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACnD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,UAAU;IACvB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;IACpC,IAAI,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO;IAE1E,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,4EAA4E;IAC5E,yEAAyE;IACzE,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1F,MAAM,iBAAiB,EAAE,CAAC;IAE1B,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,SAAS,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,sEAAsE"}

package/dist/prompts-brain.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/** Prompts for the channel brains. Local only, like the tools they drive. */
+export declare function registerBrainPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts-brain.d.ts.map

package/dist/prompts-brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts-brain.d.ts","sourceRoot":"","sources":["../src/prompts-brain.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4D5D"}

package/dist/prompts-brain.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { userMessage } from './prompts-shared.js';
+/** Prompts for the channel brains. Local only, like the tools they drive. */
+export function registerBrainPrompts(server) {
+    server.registerPrompt('create_brain', {
+        title: 'Create a brain for a YouTuber',
+        description: 'Read a channel into a searchable corpus, then write a grounded account of the creator from what they actually said.',
+        argsSchema: {
+            channel: z.string().describe('Channel URL, @handle, or name'),
+            limit: z.string().optional().describe('How many videos to read. Default: 100'),
+        },
+    }, ({ channel, limit }) => userMessage([
+        `Build a brain for the YouTube channel ${channel}, then write its profile.`,
+        '',
+        `1. build_brain with maxVideos=${limit ?? '100'}. This takes a while. If it reports`,
+        '   stoppedEarly, call it again until it does not.',
+        '2. get_brain_info to see what was actually read — a profile written over a channel',
+        '   that is half unread is a profile of the half that loaded.',
+        '3. Probe the corpus with several ask_brain calls: the subjects it returns to, the',
+        '   positions it argues for, the advice it repeats, how it opens and closes a video.',
+        '   The recurring phrases in get_brain_info are a good place to start.',
+        '4. save_brain_profile with what you found.',
+        '',
+        'Every claim in the profile must be supported by a passage you retrieved, cited as',
+        '[MM:SS] with its link. Where the corpus does not support a claim, leave the claim out.',
+        'Do not describe the creator as a person, a personality or a brand — describe what',
+        'their videos say and how they say it.',
+    ].join('\n')));
+    server.registerPrompt('ask_creator', {
+        title: 'Ask what a creator has said',
+        description: 'Answer a question strictly from a channel brain, citing the moments the answer comes from.',
+        argsSchema: {
+            channel: z.string().describe('Channel URL, @handle, or name of an existing brain'),
+            question: z.string().describe('What you want to know'),
+        },
+    }, ({ channel, question }) => userMessage([
+        `Answer this about ${channel}, using only their brain: ${question}`,
+        '',
+        '1. ask_brain with the question. Then ask again with the words the creator would',
+        '   actually use — passages are matched as spoken, not as summarised.',
+        '2. Answer from the passages you got back, citing each point as [MM:SS] with its link.',
+        '',
+        'If the passages do not answer the question, say so and say what they do cover.',
+        'Do not fill the gap from what you already know about this person: an answer that',
+        'cannot be traced to a timestamp is not an answer from the brain.',
+    ].join('\n')));
+}
+//# sourceMappingURL=prompts-brain.js.map