@muhammadhamidraza/social-media-mcp-server 1.0.0

package/dist/platforms/youtube.d.ts

@@ -0,0 +1,23 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { Platform } from "./platform.js";
+interface YouTubeConfig {
+    apiKey: string;
+}
+export declare class YouTubePlatform implements Platform {
+    name: string;
+    private apiKey;
+    private baseUrl;
+    constructor(config: YouTubeConfig);
+    getTools(): Tool[];
+    executeTool(name: string, args: unknown): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+    private searchVideos;
+    private getVideo;
+    private getComments;
+}
+export {};
+//# sourceMappingURL=youtube.d.ts.map

package/dist/platforms/youtube.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.d.ts","sourceRoot":"","sources":["../../src/platforms/youtube.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,IAAI,SAAa;IACjB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA2C;gBAE9C,MAAM,EAAE,aAAa;IAIjC,QAAQ,IAAI,IAAI,EAAE;IAyDZ,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;QACtD,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;YAaY,YAAY;YAqCZ,QAAQ;YA2CR,WAAW;CAmC1B"}

package/dist/platforms/youtube.js

@@ -0,0 +1,177 @@
+export class YouTubePlatform {
+    name = "youtube";
+    apiKey;
+    baseUrl = "https://www.googleapis.com/youtube/v3";
+    constructor(config) {
+        this.apiKey = config.apiKey;
+    }
+    getTools() {
+        return [
+            {
+                name: "youtube_search",
+                description: "Search for videos on YouTube",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "Search query"
+                        },
+                        maxResults: {
+                            type: "number",
+                            description: "Maximum number of results (default: 10)",
+                            default: 10
+                        }
+                    },
+                    required: ["query"]
+                }
+            },
+            {
+                name: "youtube_get_video",
+                description: "Get details of a specific YouTube video",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        videoId: {
+                            type: "string",
+                            description: "YouTube video ID"
+                        }
+                    },
+                    required: ["videoId"]
+                }
+            },
+            {
+                name: "youtube_get_comments",
+                description: "Get comments for a YouTube video",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        videoId: {
+                            type: "string",
+                            description: "YouTube video ID"
+                        },
+                        maxResults: {
+                            type: "number",
+                            description: "Maximum number of comments (default: 20)",
+                            default: 20
+                        }
+                    },
+                    required: ["videoId"]
+                }
+            }
+        ];
+    }
+    async executeTool(name, args) {
+        switch (name) {
+            case "youtube_search":
+                return this.searchVideos(args);
+            case "youtube_get_video":
+                return this.getVideo(args);
+            case "youtube_get_comments":
+                return this.getComments(args);
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    async searchVideos(args) {
+        const maxResults = args.maxResults || 10;
+        const url = new URL(`${this.baseUrl}/search`);
+        url.searchParams.append("part", "snippet");
+        url.searchParams.append("q", args.query);
+        url.searchParams.append("type", "video");
+        url.searchParams.append("maxResults", maxResults.toString());
+        url.searchParams.append("key", this.apiKey);
+        try {
+            const response = await fetch(url.toString());
+            if (!response.ok) {
+                throw new Error(`YouTube API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            const videos = data.items.map((item) => ({
+                id: item.id.videoId,
+                title: item.snippet.title,
+                description: item.snippet.description,
+                channelTitle: item.snippet.channelTitle,
+                publishedAt: item.snippet.publishedAt
+            }));
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(videos, null, 2)
+                    }]
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to search YouTube: ${error}`);
+        }
+    }
+    async getVideo(args) {
+        const url = new URL(`${this.baseUrl}/videos`);
+        url.searchParams.append("part", "snippet,contentDetails,statistics");
+        url.searchParams.append("id", args.videoId);
+        url.searchParams.append("key", this.apiKey);
+        try {
+            const response = await fetch(url.toString());
+            if (!response.ok) {
+                throw new Error(`YouTube API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            if (data.items.length === 0) {
+                throw new Error(`Video not found: ${args.videoId}`);
+            }
+            const video = data.items[0];
+            const result = {
+                id: video.id,
+                title: video.snippet.title,
+                description: video.snippet.description,
+                channelTitle: video.snippet.channelTitle,
+                publishedAt: video.snippet.publishedAt,
+                duration: video.contentDetails.duration,
+                viewCount: video.statistics.viewCount,
+                likeCount: video.statistics.likeCount,
+                commentCount: video.statistics.commentCount
+            };
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(result, null, 2)
+                    }]
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to get video: ${error}`);
+        }
+    }
+    async getComments(args) {
+        const maxResults = args.maxResults || 20;
+        const url = new URL(`${this.baseUrl}/commentThreads`);
+        url.searchParams.append("part", "snippet");
+        url.searchParams.append("videoId", args.videoId);
+        url.searchParams.append("maxResults", maxResults.toString());
+        url.searchParams.append("key", this.apiKey);
+        try {
+            const response = await fetch(url.toString());
+            if (!response.ok) {
+                throw new Error(`YouTube API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            const comments = data.items.map((item) => ({
+                id: item.id,
+                author: item.snippet.topLevelComment.snippet.authorDisplayName,
+                text: item.snippet.topLevelComment.snippet.textDisplay,
+                publishedAt: item.snippet.topLevelComment.snippet.publishedAt,
+                likeCount: item.snippet.topLevelComment.snippet.likeCount
+            }));
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(comments, null, 2)
+                    }]
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to get comments: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=youtube.js.map

package/dist/platforms/youtube.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@muhammadhamidraza/social-media-mcp-server",
+  "version": "1.0.0",
+  "description": "Universal MCP server for social media platforms - YouTube, LinkedIn, Facebook, Instagram, TikTok, Twitter/X",
+  "main": "dist/index.js",
+  "bin": {
+    "social-media-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "social-media",
+    "api",
+    "youtube",
+    "linkedin",
+    "facebook",
+    "instagram",
+    "tiktok",
+    "twitter"
+  ],
+  "author": "Social Media MCP Server",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "node-fetch": "^3.3.2",
+    "@types/node-fetch": "^2.6.9",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.2",
+    "jest": "^29.7.0",
+    "@types/jest": "^29.5.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "module"
+}