youtube-knowledge-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 teobouancheau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,225 @@
+# YouTube Knowledge MCP
+
+[![npm version](https://img.shields.io/npm/v/youtube-knowledge-mcp.svg)](https://www.npmjs.com/package/youtube-knowledge-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org/)
+
+MCP Server for extracting and managing YouTube video knowledge.
+
+## Features
+
+- **Fetch videos** from playlists or channels
+- **Get video info** (title, channel, duration, description, tags)
+- **Extract transcripts** (auto-generated or manual captions)
+- **Download videos** with quality selection and format options
+- **Save to library** (summaries, notes, skills)
+- **List library** with tag filtering
+
+## Prerequisites
+
+- Node.js 20+
+- yt-dlp: `brew install yt-dlp` (macOS) or [see installation guide](https://github.com/yt-dlp/yt-dlp#installation)
+
+## Installation
+
+### Via npm (Recommended)
+
+```bash
+npm install -g youtube-knowledge-mcp
+```
+
+### Via npx (no installation)
+
+Configure directly with npx (see Configuration section).
+
+### From source
+
+```bash
+git clone https://github.com/teobouancheau/youtube-knowledge-mcp.git
+cd youtube-knowledge-mcp
+npm install
+npm run build
+```
+
+## Configuration
+
+### With npx (Recommended)
+
+Add to your Claude Code MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "youtube-knowledge": {
+      "command": "npx",
+      "args": ["-y", "youtube-knowledge-mcp"]
+    }
+  }
+}
+```
+
+### With npm global
+
+```json
+{
+  "mcpServers": {
+    "youtube-knowledge": {
+      "command": "youtube-knowledge-mcp"
+    }
+  }
+}
+```
+
+### From source
+
+```json
+{
+  "mcpServers": {
+    "youtube-knowledge": {
+      "command": "node",
+      "args": ["/path/to/youtube-knowledge-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+Then restart Claude Code to load the new MCP server.
+
+## MCP Tools
+
+### youtube_fetch_videos
+
+List videos from a YouTube playlist or channel.
+
+| Parameter | Type   | Default  | Description                     |
+| --------- | ------ | -------- | ------------------------------- |
+| `url`     | string | required | YouTube playlist or channel URL |
+| `limit`   | number | 20       | Maximum videos to fetch         |
+
+### youtube_get_video_info
+
+Get detailed metadata for a YouTube video.
+
+| Parameter | Type   | Description     |
+| --------- | ------ | --------------- |
+| `video`   | string | Video ID or URL |
+
+**Returns:** title, channel, duration, description, tags, thumbnail
+
+### youtube_get_transcript
+
+Extract transcript/subtitles from a YouTube video.
+
+| Parameter  | Type   | Default  | Description             |
+| ---------- | ------ | -------- | ----------------------- |
+| `video`    | string | required | Video ID or URL         |
+| `language` | string | "en"     | Preferred language code |
+
+### youtube_list_formats
+
+List available download formats for a YouTube video.
+
+| Parameter | Type   | Description     |
+| --------- | ------ | --------------- |
+| `video`   | string | Video ID or URL |
+
+**Returns:** format IDs, resolutions, codecs, file sizes
+
+### youtube_download_video
+
+Download a YouTube video with quality selection.
+
+| Parameter   | Type   | Default | Description                                              |
+| ----------- | ------ | ------- | -------------------------------------------------------- |
+| `video`     | string | required| Video ID or URL                                          |
+| `quality`   | string | "best"  | Quality preset (best, 2160p, 1440p, 1080p, 720p, 480p, 360p, audio) |
+| `formatId`  | string | -       | Specific format code from youtube_list_formats           |
+| `outputDir` | string | -       | Custom output directory                                  |
+
+### youtube_save_to_library
+
+Save content to your personal YouTube knowledge library.
+
+| Parameter      | Type     | Description          |
+| -------------- | -------- | -------------------- |
+| `video_id`     | string   | YouTube video ID     |
+| `title`        | string   | Video title          |
+| `content`      | string   | Content to save      |
+| `content_type` | string   | "summary" or "skill" |
+| `tags`         | string[] | Optional tags        |
+| `channel`      | string   | Optional channel name|
+
+### youtube_list_library
+
+List all saved items in your library.
+
+| Parameter | Type   | Description            |
+| --------- | ------ | ---------------------- |
+| `tag`     | string | Optional filter by tag |
+
+## Library Storage
+
+Content is stored in `~/.youtube-knowledge/`:
+
+```
+~/.youtube-knowledge/
+├── transcripts/          # Cached transcripts
+│   └── {video_id}.txt
+├── library/              # Saved content
+│   └── {video_id}/
+│       ├── metadata.json
+│       ├── summary.md
+│       └── skill.md
+├── downloads/            # Downloaded videos
+│   └── {video_title}.{ext}
+└── index.json            # Searchable index
+```
+
+## Usage Examples
+
+### Quick summary
+
+```
+"Summarize this video: https://youtube.com/watch?v=ABC123"
+```
+
+### Explore a channel
+
+```
+"Show me the latest videos from @ThePrimeagen"
+```
+
+### Download a video
+
+```
+"Download this video in 1080p: https://youtube.com/watch?v=ABC123"
+```
+
+### Save to library
+
+```
+"Save this summary with tags: programming, productivity"
+```
+
+### Create a skill
+
+```
+"Create a Claude Code skill from this video's content"
+```
+
+## Development
+
+```bash
+npm run dev      # Watch mode
+npm run build    # Build for production
+npm run rebuild  # Clean and rebuild
+npm start        # Run the server
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+[MIT](LICENSE) © 2026 teobouancheau

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { fetchVideosSchema, fetchVideosHandler } from './tools/fetch-videos.js';
+import { getVideoInfoSchema, getVideoInfoHandler } from './tools/get-video-info.js';
+import { getTranscriptSchema, getTranscriptHandler } from './tools/get-transcript.js';
+import { saveToLibrarySchema, saveToLibraryHandler } from './tools/save-to-library.js';
+import { listLibrarySchema, listLibraryHandler } from './tools/list-library.js';
+import { listFormatsSchema, listFormatsHandler, downloadVideoSchema, downloadVideoHandler, } from './tools/download-video.js';
+const server = new McpServer({
+    name: 'youtube-knowledge-extractor',
+    version: '1.0.0',
+});
+// Tool 1: Fetch videos from playlist or channel
+server.registerTool('youtube_fetch_videos', {
+    title: 'Fetch YouTube Videos',
+    description: 'List videos from a YouTube playlist or channel. Returns video IDs, titles, durations, and dates.',
+    inputSchema: fetchVideosSchema,
+}, fetchVideosHandler);
+// Tool 2: Get video info
+server.registerTool('youtube_get_video_info', {
+    title: 'Get Video Info',
+    description: 'Get detailed metadata for a YouTube video including title, channel, duration, description, and tags.',
+    inputSchema: getVideoInfoSchema,
+}, getVideoInfoHandler);
+// Tool 3: Get transcript
+server.registerTool('youtube_get_transcript', {
+    title: 'Get Video Transcript',
+    description: 'Extract the transcript/subtitles from a YouTube video. Supports auto-generated and manual captions.',
+    inputSchema: getTranscriptSchema,
+}, getTranscriptHandler);
+// Tool 4: Save to library
+server.registerTool('youtube_save_to_library', {
+    title: 'Save to Library',
+    description: 'Save a summary, notes, or skill to your personal YouTube knowledge library.',
+    inputSchema: saveToLibrarySchema,
+}, saveToLibraryHandler);
+// Tool 5: List library
+server.registerTool('youtube_list_library', {
+    title: 'List Library',
+    description: 'List all saved items in your YouTube knowledge library. Optionally filter by tag.',
+    inputSchema: listLibrarySchema,
+}, listLibraryHandler);
+// Tool 6: List video formats
+server.registerTool('youtube_list_formats', {
+    title: 'List Video Formats',
+    description: 'List available download formats for a YouTube video. Returns format IDs, resolutions, codecs, and file sizes.',
+    inputSchema: listFormatsSchema,
+}, listFormatsHandler);
+// Tool 7: Download video
+server.registerTool('youtube_download_video', {
+    title: 'Download Video',
+    description: 'Download a YouTube video. Use quality parameter (best, 1080p, 720p, etc.) for automatic best format selection with fallbacks. Or use formatId for specific formats from youtube_list_formats.',
+    inputSchema: downloadVideoSchema,
+}, downloadVideoHandler);
+// Connect via stdio transport
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('Failed to start MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,6BAA6B;IACnC,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;IACE,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACT,kGAAkG;IACpG,WAAW,EAAE,iBAAiB;CAC/B,EACD,kBAAkB,CACnB,CAAC;AAEF,yBAAyB;AACzB,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;IACE,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,sGAAsG;IACxG,WAAW,EAAE,kBAAkB;CAChC,EACD,mBAAmB,CACpB,CAAC;AAEF,yBAAyB;AACzB,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;IACE,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACT,qGAAqG;IACvG,WAAW,EAAE,mBAAmB;CACjC,EACD,oBAAoB,CACrB,CAAC;AAEF,0BAA0B;AAC1B,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;IACE,KAAK,EAAE,iBAAiB;IACxB,WAAW,EAAE,6EAA6E;IAC1F,WAAW,EAAE,mBAAmB;CACjC,EACD,oBAAoB,CACrB,CAAC;AAEF,uBAAuB;AACvB,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;IACE,KAAK,EAAE,cAAc;IACrB,WAAW,EACT,mFAAmF;IACrF,WAAW,EAAE,iBAAiB;CAC/B,EACD,kBAAkB,CACnB,CAAC;AAEF,6BAA6B;AAC7B,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;IACE,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,+GAA+G;IACjH,WAAW,EAAE,iBAAiB;CAC/B,EACD,kBAAkB,CACnB,CAAC;AAEF,yBAAyB;AACzB,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;IACE,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,+LAA+L;IACjM,WAAW,EAAE,mBAAmB;CACjC,EACD,oBAAoB,CACrB,CAAC;AAEF,8BAA8B;AAC9B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/download-video.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { VideoQuality } from '../utils/youtube.js';
+export declare const listFormatsSchema: {
+    video: z.ZodString;
+};
+export declare function listFormatsHandler({ video }: {
+    video: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare const downloadVideoSchema: {
+    video: z.ZodString;
+    quality: z.ZodOptional<z.ZodEnum<["best", "2160p", "1440p", "1080p", "720p", "480p", "360p", "audio"]>>;
+    formatId: z.ZodOptional<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+};
+export declare function downloadVideoHandler({ video, quality, formatId, outputDir, }: {
+    video: string;
+    quality?: VideoQuality;
+    formatId?: string;
+    outputDir?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=download-video.d.ts.map

package/dist/tools/download-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-video.d.ts","sourceRoot":"","sources":["../../src/tools/download-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA8B,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG/E,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AASF,wBAAsB,kBAAkB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE;;;;;GAmDpE;AAGD,eAAO,MAAM,mBAAmB;;;;;CAc/B,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,EACzC,KAAK,EACL,OAAO,EACP,QAAQ,EACR,SAAS,GACV,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;GAyCA"}

package/dist/tools/download-video.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { listFormats, downloadVideo } from '../utils/youtube.js';
+// Tool 1: List available formats
+export const listFormatsSchema = {
+    video: z.string().describe('YouTube video ID or URL'),
+};
+function formatFilesize(bytes) {
+    if (!bytes)
+        return 'Unknown';
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+    return `${(bytes / 1024 / 1024 / 1024).toFixed(2)} GB`;
+}
+export async function listFormatsHandler({ video }) {
+    const formats = await listFormats(video);
+    const lines = [`${formats.length} formats available`, ''];
+    const combined = formats.filter((f) => f.vcodec !== 'none' && f.acodec !== 'none');
+    const videoOnly = formats.filter((f) => f.vcodec !== 'none' && f.acodec === 'none');
+    const audioOnly = formats.filter((f) => f.vcodec === 'none' && f.acodec !== 'none');
+    if (combined.length > 0) {
+        lines.push('video + audio:');
+        combined.forEach((f) => {
+            const fps = f.fps ? ` ${f.fps}fps` : '';
+            lines.push(`  ${f.formatId} · ${f.ext} · ${f.resolution}${fps} · ${formatFilesize(f.filesize)}`);
+        });
+    }
+    if (videoOnly.length > 0) {
+        lines.push('');
+        lines.push('video only:');
+        videoOnly.forEach((f) => {
+            const fps = f.fps ? ` ${f.fps}fps` : '';
+            lines.push(`  ${f.formatId} · ${f.ext} · ${f.resolution}${fps} · ${formatFilesize(f.filesize)}`);
+        });
+    }
+    if (audioOnly.length > 0) {
+        lines.push('');
+        lines.push('audio only:');
+        audioOnly.forEach((f) => {
+            lines.push(`  ${f.formatId} · ${f.ext} · ${f.acodec} · ${formatFilesize(f.filesize)}`);
+        });
+    }
+    if (combined.length === 0) {
+        lines.push('');
+        lines.push('tip: combine formats like "137+140" for video+audio');
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: lines.join('\n'),
+            },
+        ],
+    };
+}
+// Tool 2: Download video with selected format
+export const downloadVideoSchema = {
+    video: z.string().describe('YouTube video ID or URL'),
+    quality: z
+        .enum(['best', '2160p', '1440p', '1080p', '720p', '480p', '360p', 'audio'])
+        .optional()
+        .describe('Quality preset (recommended). Uses smart format selection with fallbacks. Options: best, 2160p, 1440p, 1080p, 720p, 480p, 360p, audio'),
+    formatId: z
+        .string()
+        .optional()
+        .describe('Advanced: Specific format code from list_formats (e.g., "22", "137+140"). Use quality instead for automatic best format selection.'),
+    outputDir: z
+        .string()
+        .optional()
+        .describe('Output directory (defaults to ~/.youtube-knowledge/downloads/)'),
+};
+export async function downloadVideoHandler({ video, quality, formatId, outputDir, }) {
+    // Validate: at least one of quality or formatId must be provided
+    if (!quality && !formatId) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Error: Please provide either quality (recommended: "best", "1080p", etc.) or formatId',
+                },
+            ],
+            isError: true,
+        };
+    }
+    // If quality is provided, use it; otherwise use formatId
+    const result = await downloadVideo(video, formatId ?? 'best', // formatId is only used if quality is not provided
+    outputDir, quality);
+    const qualityLabel = quality ? `quality: ${quality}` : `format: ${result.format}`;
+    const lines = [
+        `✓ Downloaded`,
+        '',
+        result.title,
+        qualityLabel,
+        '',
+        result.filePath,
+    ];
+    return {
+        content: [
+            {
+                type: 'text',
+                text: lines.join('\n'),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=download-video.js.map

package/dist/tools/download-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-video.js","sourceRoot":"","sources":["../../src/tools/download-video.ts"],"names":[],"mappings":"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"}

package/dist/tools/fetch-videos.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export declare const fetchVideosSchema: {
+    url: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+export declare function fetchVideosHandler({ url, limit }: {
+    url: string;
+    limit: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=fetch-videos.d.ts.map

package/dist/tools/fetch-videos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-videos.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB;;;CAG7B,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;;;;;GAoBtF"}

package/dist/tools/fetch-videos.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { listVideos } from '../utils/youtube.js';
+export const fetchVideosSchema = {
+    url: z.string().describe('YouTube playlist or channel URL'),
+    limit: z.number().min(1).max(100).default(20).describe('Maximum number of videos to fetch'),
+};
+export async function fetchVideosHandler({ url, limit }) {
+    const videos = await listVideos(url, limit);
+    const lines = [`✓ Found ${videos.length} video${videos.length !== 1 ? 's' : ''}`, ''];
+    videos.forEach((v, i) => {
+        lines.push(`${i + 1}. ${v.title}`);
+        lines.push(`   ${v.durationFormatted} · ${v.uploadDate || 'Unknown date'}`);
+        lines.push(`   ${v.url}`);
+        lines.push('');
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: lines.join('\n'),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=fetch-videos.js.map

package/dist/tools/fetch-videos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-videos.js","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC3D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CAC5F,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAkC;IACrF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAa,CAAC,WAAW,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,iBAAiB,MAAM,CAAC,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;aACvB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-transcript.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export declare const getTranscriptSchema: {
+    video: z.ZodString;
+    language: z.ZodDefault<z.ZodString>;
+};
+export declare function getTranscriptHandler({ video, language, }: {
+    video: string;
+    language: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=get-transcript.d.ts.map

package/dist/tools/get-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-transcript.d.ts","sourceRoot":"","sources":["../../src/tools/get-transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB;;;CAG/B,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,EACzC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;;;;;GAoBA"}

package/dist/tools/get-transcript.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { getTranscript } from '../utils/youtube.js';
+export const getTranscriptSchema = {
+    video: z.string().describe('YouTube video ID or URL'),
+    language: z.string().default('en').describe('Preferred language code (e.g., en, fr, es)'),
+};
+export async function getTranscriptHandler({ video, language, }) {
+    const result = await getTranscript(video, language);
+    const wordCount = result.transcript.split(/\s+/).length;
+    const lines = [
+        `Transcript (${result.language})`,
+        `${wordCount.toLocaleString()} words`,
+        '',
+        result.transcript,
+    ];
+    return {
+        content: [
+            {
+                type: 'text',
+                text: lines.join('\n'),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-transcript.js.map

package/dist/tools/get-transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-transcript.js","sourceRoot":"","sources":["../../src/tools/get-transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC1F,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EACzC,KAAK,EACL,QAAQ,GAIT;IACC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAExD,MAAM,KAAK,GAAa;QACtB,eAAe,MAAM,CAAC,QAAQ,GAAG;QACjC,GAAG,SAAS,CAAC,cAAc,EAAE,QAAQ;QACrC,EAAE;QACF,MAAM,CAAC,UAAU;KAClB,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;aACvB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-video-info.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const getVideoInfoSchema: {
+    video: z.ZodString;
+};
+export declare function getVideoInfoHandler({ video }: {
+    video: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=get-video-info.d.ts.map

package/dist/tools/get-video-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-video-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-video-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kBAAkB;;CAE9B,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE;;;;;GA6BrE"}

package/dist/tools/get-video-info.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { getVideoInfo } from '../utils/youtube.js';
+export const getVideoInfoSchema = {
+    video: z.string().describe('YouTube video ID or URL'),
+};
+export async function getVideoInfoHandler({ video }) {
+    const info = await getVideoInfo(video);
+    const lines = [
+        info.title,
+        `by ${info.channel}`,
+        '',
+        `${info.durationFormatted} · ${info.uploadDate || 'Unknown date'}`,
+        info.url,
+    ];
+    if (info.tags.length > 0) {
+        lines.push('');
+        lines.push(`tags: ${info.tags.join(', ')}`);
+    }
+    if (info.description) {
+        lines.push('');
+        lines.push(info.description);
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: lines.join('\n'),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-video-info.js.map

package/dist/tools/get-video-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-video-info.js","sourceRoot":"","sources":["../../src/tools/get-video-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACtD,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EAAE,KAAK,EAAqB;IACpE,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,KAAK;QACV,MAAM,IAAI,CAAC,OAAO,EAAE;QACpB,EAAE;QACF,GAAG,IAAI,CAAC,iBAAiB,MAAM,IAAI,CAAC,UAAU,IAAI,cAAc,EAAE;QAClE,IAAI,CAAC,GAAG;KACT,CAAC;IAEF,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;aACvB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-library.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const listLibrarySchema: {
+    tag: z.ZodOptional<z.ZodString>;
+};
+export declare function listLibraryHandler({ tag }: {
+    tag?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=list-library.d.ts.map

package/dist/tools/list-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-library.d.ts","sourceRoot":"","sources":["../../src/tools/list-library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;GAuCjE"}