@yilin-jing/youtube-mcp-server 1.2.0 → 1.3.0

package/dist/cleaners.d.ts

@@ -8,4 +8,6 @@ export declare const DataCleaners: {
     cleanVideoList: (videos: any[]) => any[];
     cleanSearchResults: (items: any[]) => any[];
     cleanPlaylistItems: (items: any[]) => any[];
+    cleanComment: (item: any) => any;
+    cleanComments: (result: any) => any;
 };

package/dist/cleaners.js

@@ -108,4 +108,38 @@ export const DataCleaners = {
             return [];
         return items.map(DataCleaners.cleanPlaylistItem).filter(Boolean);
     },
+    cleanComment: (item) => {
+        if (!item)
+            return null;
+        const snippet = item.snippet || {};
+        const topComment = snippet.topLevelComment?.snippet || {};
+        return {
+            id: item.id,
+            author: topComment.authorDisplayName,
+            authorChannelId: topComment.authorChannelId?.value,
+            text: topComment.textDisplay,
+            likes: topComment.likeCount ? parseInt(topComment.likeCount) : 0,
+            published: topComment.publishedAt,
+            updated: topComment.updatedAt,
+            replyCount: snippet.totalReplyCount || 0,
+            replies: item.replies?.comments?.map((reply) => ({
+                id: reply.id,
+                author: reply.snippet?.authorDisplayName,
+                authorChannelId: reply.snippet?.authorChannelId?.value,
+                text: reply.snippet?.textDisplay,
+                likes: reply.snippet?.likeCount ? parseInt(reply.snippet.likeCount) : 0,
+                published: reply.snippet?.publishedAt,
+            })) || [],
+        };
+    },
+    cleanComments: (result) => {
+        if (!result)
+            return { comments: [], nextPageToken: null };
+        const items = result.items || [];
+        return {
+            comments: items.map(DataCleaners.cleanComment).filter(Boolean),
+            nextPageToken: result.nextPageToken || null,
+            totalResults: result.pageInfo?.totalResults,
+        };
+    },
 };

package/dist/server.js

@@ -8,6 +8,7 @@ import { VideoService } from './services/video.js';
 import { TranscriptService } from './services/transcript.js';
 import { PlaylistService } from './services/playlist.js';
 import { ChannelService } from './services/channel.js';
+import { CommentService } from './services/comment.js';
 import { DataCleaners } from './cleaners.js';
 function saveData(data, dir, toolName) {
     try {
@@ -36,12 +37,13 @@ function formatResponse(cleanedData, options) {
 export async function startMcpServer() {
     const server = new McpServer({
         name: 'youtube-mcp-server',
-        version: '1.2.0',
+        version: '1.3.0',
     });
     const videoService = new VideoService();
     const transcriptService = new TranscriptService();
     const playlistService = new PlaylistService();
     const channelService = new ChannelService();
+    const commentService = new CommentService();
     server.tool('videos_getVideo', 'Get video info. Returns cleaned data in TOON format.', {
         videoId: z.string().describe('The YouTube video ID'),
         parts: z.array(z.string()).optional().describe('Parts to retrieve'),
@@ -103,6 +105,18 @@ export async function startMcpServer() {
         const cleaned = DataCleaners.cleanPlaylistItems(result);
         return formatResponse(cleaned, { ...(save_dir && { saveDir: save_dir }), toolName: 'playlists_getPlaylistItems' });
     });
+    server.tool('comments_getComments', 'Get video comments. Returns cleaned data in TOON format.', {
+        videoId: z.string().describe('The YouTube video ID'),
+        maxResults: z.number().optional().describe('Max results (1-100, default: 100)'),
+        order: z.enum(['time', 'relevance']).optional().describe('Sort order (default: relevance)'),
+        pageToken: z.string().optional().describe('Page token for pagination'),
+        textFormat: z.enum(['html', 'plainText']).optional().describe('Text format (default: plainText)'),
+        save_dir: z.string().optional().describe('Directory to save cleaned JSON'),
+    }, async ({ videoId, maxResults, order, pageToken, textFormat, save_dir }) => {
+        const result = await commentService.getComments({ videoId, maxResults, order, pageToken, textFormat });
+        const cleaned = DataCleaners.cleanComments(result);
+        return formatResponse(cleaned, { ...(save_dir && { saveDir: save_dir }), toolName: 'comments_getComments' });
+    });
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error(`YouTube MCP Server v1.2.0 started successfully`);

package/dist/services/comment.d.ts

@@ -0,0 +1,17 @@
+import { CommentParams } from '../types.js';
+/**
+ * Service for interacting with YouTube comments
+ */
+export declare class CommentService {
+    private youtube;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the YouTube client only when needed
+     */
+    private initialize;
+    /**
+     * Get comments for a YouTube video
+     */
+    getComments({ videoId, maxResults, order, pageToken, textFormat }: CommentParams): Promise<any>;
+}

package/dist/services/comment.js

@@ -0,0 +1,47 @@
+import { google } from 'googleapis';
+/**
+ * Service for interacting with YouTube comments
+ */
+export class CommentService {
+    youtube;
+    initialized = false;
+    constructor() {
+        // Don't initialize in constructor
+    }
+    /**
+     * Initialize the YouTube client only when needed
+     */
+    initialize() {
+        if (this.initialized)
+            return;
+        const apiKey = process.env.YOUTUBE_API_KEY;
+        if (!apiKey) {
+            throw new Error('YOUTUBE_API_KEY environment variable is not set.');
+        }
+        this.youtube = google.youtube({
+            version: 'v3',
+            auth: apiKey
+        });
+        this.initialized = true;
+    }
+    /**
+     * Get comments for a YouTube video
+     */
+    async getComments({ videoId, maxResults = 100, order = 'relevance', pageToken, textFormat = 'plainText' }) {
+        try {
+            this.initialize();
+            const response = await this.youtube.commentThreads.list({
+                part: ['snippet', 'replies'],
+                videoId,
+                maxResults,
+                order,
+                pageToken,
+                textFormat
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw new Error(`Failed to get comments: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}

package/dist/types.d.ts

@@ -68,3 +68,13 @@ export interface PlaylistItemsParams {
     playlistId: string;
     maxResults?: number;
 }
+/**
+ * Comment parameters
+ */
+export interface CommentParams {
+    videoId: string;
+    maxResults?: number;
+    order?: 'time' | 'relevance';
+    pageToken?: string;
+    textFormat?: 'html' | 'plainText';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yilin-jing/youtube-mcp-server",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "YouTube MCP Server with TOON format for 90%+ token savings",
   "type": "module",
   "main": "dist/index.js",