bn-facebook-mcp-server 0.0.1

package/dist/tool-registry.js

@@ -0,0 +1,54 @@
+import { wrapWithDebug } from "./debug-middleware.js";
+/**
+ * Registry for managing and executing MCP tools with automatic debug wrapping
+ */
+export class ToolRegistry {
+    tools = new Map();
+    /**
+     * Register a new tool in the registry
+     *
+     * @param name - Unique name of the tool
+     * @param schema - Zod schema for validating tool input
+     * @param handler - Async function that executes the tool logic
+     */
+    register(name, schema, handler) {
+        this.tools.set(name, { name, schema, handler });
+    }
+    /**
+     * Execute a tool by name with automatic validation and debug wrapping
+     *
+     * @param toolName - Name of the tool to execute
+     * @param rawInput - Raw input arguments (will be validated against schema)
+     * @param req - Express request object for accessing headers/context
+     * @returns ToolResponse with data and optional debug metadata
+     * @throws Error if tool is not found or validation fails
+     */
+    async execute(toolName, rawInput, req) {
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${toolName}`);
+        }
+        // Validate input against schema
+        const args = tool.schema.parse(rawInput);
+        // Execute with debug wrapping
+        return wrapWithDebug(toolName, args, () => tool.handler(req, args));
+    }
+    /**
+     * Check if a tool exists in the registry
+     *
+     * @param toolName - Name of the tool to check
+     * @returns True if the tool is registered
+     */
+    has(toolName) {
+        return this.tools.has(toolName);
+    }
+    /**
+     * Get all registered tool names
+     *
+     * @returns Array of registered tool names
+     */
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAerD;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAA;IAEjD;;;;;;OAMG;IACH,QAAQ,CAAC,IAAY,EAAE,MAAkB,EAAE,OAAoB;QAC7D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;IACjD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CACX,QAAgB,EAChB,QAAiB,EACjB,GAAY;QAEZ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAErC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAA;QAC9C,CAAC;QAED,gCAAgC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QAExC,8BAA8B;QAC9B,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAA;IACrE,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjC,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACtC,CAAC;CACF"}

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Export all tool handlers for Facebook MCP Server
+ */
+export { getMe, getFriends, getPhotos, getUserPosts, getVideos, getLikes, getPermissions, } from "./user.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,KAAK,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,cAAc,GACf,MAAM,WAAW,CAAA"}

package/dist/tools/index.js

@@ -0,0 +1,6 @@
+/**
+ * Export all tool handlers for Facebook MCP Server
+ */
+// User tools
+export { getMe, getFriends, getPhotos, getUserPosts, getVideos, getLikes, getPermissions, } from "./user.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,aAAa;AACb,OAAO,EACL,KAAK,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,cAAc,GACf,MAAM,WAAW,CAAA"}

package/dist/tools/instagram.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Instagram tool handlers - REMOVED
+ *
+ * These tools were removed because the required Facebook OAuth scopes
+ * (instagram_basic, instagram_manage_insights, instagram_content_publish)
+ * are not available.
+ */
+export {};
+//# sourceMappingURL=instagram.d.ts.map

package/dist/tools/instagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram.d.ts","sourceRoot":"","sources":["../../src/tools/instagram.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAA"}

package/dist/tools/instagram.js

@@ -0,0 +1,9 @@
+/**
+ * Instagram tool handlers - REMOVED
+ *
+ * These tools were removed because the required Facebook OAuth scopes
+ * (instagram_basic, instagram_manage_insights, instagram_content_publish)
+ * are not available.
+ */
+export {};
+//# sourceMappingURL=instagram.js.map

package/dist/tools/instagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram.js","sourceRoot":"","sources":["../../src/tools/instagram.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/pages.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Facebook Pages tool handlers - REMOVED
+ *
+ * These tools were removed because the required Facebook OAuth scopes
+ * (pages_show_list, pages_read_engagement, pages_manage_posts) are not available.
+ */
+export {};
+//# sourceMappingURL=pages.d.ts.map

package/dist/tools/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/tools/pages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAA"}

package/dist/tools/pages.js

@@ -0,0 +1,8 @@
+/**
+ * Facebook Pages tool handlers - REMOVED
+ *
+ * These tools were removed because the required Facebook OAuth scopes
+ * (pages_show_list, pages_read_engagement, pages_manage_posts) are not available.
+ */
+export {};
+//# sourceMappingURL=pages.js.map

package/dist/tools/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../src/tools/pages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/tools/system.d.ts

@@ -0,0 +1,7 @@
+/**
+ * System tool handlers - REMOVED
+ *
+ * All system tools have been removed from the Facebook MCP server.
+ */
+export {};
+//# sourceMappingURL=system.d.ts.map

package/dist/tools/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAA"}

package/dist/tools/system.js

@@ -0,0 +1,7 @@
+/**
+ * System tool handlers - REMOVED
+ *
+ * All system tools have been removed from the Facebook MCP server.
+ */
+export {};
+//# sourceMappingURL=system.js.map

package/dist/tools/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/tools/user.d.ts

@@ -0,0 +1,105 @@
+/**
+ * User tool handlers for Facebook MCP Server
+ */
+import type { Request } from "express";
+/**
+ * Get current user profile
+ */
+export declare function getMe(req: Request, args: unknown): Promise<{
+    success: boolean;
+    user: import("../types.js").FacebookUser;
+    note: string;
+}>;
+/**
+ * Get user's friends (requires user_friends permission)
+ */
+export declare function getFriends(req: Request, args: unknown): Promise<{
+    success: boolean;
+    friends: {
+        id: string;
+        name: string;
+        picture?: unknown;
+    }[];
+    pagination: import("../types.js").PaginationInfo;
+    summary: {
+        current_page_count: number;
+        total_count: number;
+        has_more: boolean;
+    };
+    note: string;
+}>;
+/**
+ * Get user's photos (requires user_photos permission)
+ */
+export declare function getPhotos(req: Request, args: unknown): Promise<{
+    success: boolean;
+    photos: unknown[];
+    pagination: import("../types.js").PaginationInfo;
+    summary: {
+        current_page_count: number;
+        total_count: number;
+        has_more: boolean;
+    };
+    note: string;
+}>;
+/**
+ * Get user's posts (requires user_posts permission)
+ */
+export declare function getUserPosts(req: Request, args: unknown): Promise<{
+    success: boolean;
+    posts: import("../types.js").FacebookPost[];
+    pagination: import("../types.js").PaginationInfo;
+    summary: {
+        current_page_count: number;
+        total_count: number;
+        has_more: boolean;
+    };
+    note: string;
+}>;
+/**
+ * Get user's videos (requires user_videos permission)
+ */
+export declare function getVideos(req: Request, args: unknown): Promise<{
+    success: boolean;
+    videos: unknown[];
+    pagination: import("../types.js").PaginationInfo;
+    summary: {
+        current_page_count: number;
+        total_count: number;
+        has_more: boolean;
+    };
+    note: string;
+}>;
+/**
+ * Get user's likes (requires user_likes permission)
+ */
+export declare function getLikes(req: Request, args: unknown): Promise<{
+    success: boolean;
+    likes: unknown[];
+    pagination: import("../types.js").PaginationInfo;
+    summary: {
+        current_page_count: number;
+        total_count: number;
+        has_more: boolean;
+    };
+    note: string;
+}>;
+/**
+ * Get user permissions for the current access token
+ */
+export declare function getPermissions(req: Request, _args: unknown): Promise<{
+    success: boolean;
+    permissions: {
+        permission: string;
+        status: string;
+    }[];
+    summary: {
+        total: number;
+        granted: number;
+        declined: number;
+        granted_permissions: string[];
+        declined_permissions: string[];
+    };
+    note: string;
+}>;
+//# sourceMappingURL=user.d.ts.map

package/dist/tools/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/tools/user.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAGtC;;GAEG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO;;;;GAWtD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO;;;;;;;;;;;;;;GAqB3D;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO;;;;;;;;;;GAqB1D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO;;;;;;;;;;GAqB7D;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO;;;;;;;;;;GAqB1D;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO;;;;;;;;;;GAqBzD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;;;;;;;;;;;;;;GAyBhE"}

package/dist/tools/user.js

@@ -0,0 +1,139 @@
+/**
+ * User tool handlers for Facebook MCP Server
+ */
+import { getFacebookClient } from "../facebook-api-client.js";
+/**
+ * Get current user profile
+ */
+export async function getMe(req, args) {
+    const client = getFacebookClient(req);
+    const { fields } = args;
+    const user = await client.getMe(fields);
+    return {
+        success: true,
+        user,
+        note: "User profile retrieved successfully",
+    };
+}
+/**
+ * Get user's friends (requires user_friends permission)
+ */
+export async function getFriends(req, args) {
+    const client = getFacebookClient(req);
+    const { page, limit, fields } = args;
+    const result = await client.getFriends(page, limit, fields);
+    return {
+        success: true,
+        friends: result.data,
+        pagination: result.pagination,
+        summary: {
+            current_page_count: result.data.length,
+            total_count: result.pagination.total,
+            has_more: result.pagination.hasNext,
+        },
+        note: "Only returns friends who also use the app. Use page parameter to navigate pages.",
+    };
+}
+/**
+ * Get user's photos (requires user_photos permission)
+ */
+export async function getPhotos(req, args) {
+    const client = getFacebookClient(req);
+    const { page, limit, fields } = args;
+    const result = await client.getPhotos(page, limit, fields);
+    return {
+        success: true,
+        photos: result.data,
+        pagination: result.pagination,
+        summary: {
+            current_page_count: result.data.length,
+            total_count: result.pagination.total,
+            has_more: result.pagination.hasNext,
+        },
+        note: "Photos retrieved successfully. Use page parameter to navigate pages.",
+    };
+}
+/**
+ * Get user's posts (requires user_posts permission)
+ */
+export async function getUserPosts(req, args) {
+    const client = getFacebookClient(req);
+    const { page, limit, fields } = args;
+    const result = await client.getPosts(page, limit, fields);
+    return {
+        success: true,
+        posts: result.data,
+        pagination: result.pagination,
+        summary: {
+            current_page_count: result.data.length,
+            total_count: result.pagination.total,
+            has_more: result.pagination.hasNext,
+        },
+        note: "User posts retrieved successfully. Use page parameter to navigate pages.",
+    };
+}
+/**
+ * Get user's videos (requires user_videos permission)
+ */
+export async function getVideos(req, args) {
+    const client = getFacebookClient(req);
+    const { page, limit, fields } = args;
+    const result = await client.getVideos(page, limit, fields);
+    return {
+        success: true,
+        videos: result.data,
+        pagination: result.pagination,
+        summary: {
+            current_page_count: result.data.length,
+            total_count: result.pagination.total,
+            has_more: result.pagination.hasNext,
+        },
+        note: "Videos retrieved successfully. Use page parameter to navigate pages.",
+    };
+}
+/**
+ * Get user's likes (requires user_likes permission)
+ */
+export async function getLikes(req, args) {
+    const client = getFacebookClient(req);
+    const { page, limit, fields } = args;
+    const result = await client.getLikes(page, limit, fields);
+    return {
+        success: true,
+        likes: result.data,
+        pagination: result.pagination,
+        summary: {
+            current_page_count: result.data.length,
+            total_count: result.pagination.total,
+            has_more: result.pagination.hasNext,
+        },
+        note: "Liked pages retrieved successfully. Use page parameter to navigate pages.",
+    };
+}
+/**
+ * Get user permissions for the current access token
+ */
+export async function getPermissions(req, _args) {
+    const client = getFacebookClient(req);
+    const permissions = await client.getPermissions();
+    // Organize permissions by status
+    const granted = permissions
+        .filter((p) => p.status === "granted")
+        .map((p) => p.permission);
+    const declined = permissions
+        .filter((p) => p.status === "declined")
+        .map((p) => p.permission);
+    return {
+        success: true,
+        permissions,
+        summary: {
+            total: permissions.length,
+            granted: granted.length,
+            declined: declined.length,
+            granted_permissions: granted,
+            declined_permissions: declined,
+        },
+        note: "Permission list retrieved successfully",
+    };
+}
+//# sourceMappingURL=user.js.map

package/dist/tools/user.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Type definitions for Facebook/Instagram MCP Server
+ */
+export interface GraphApiResponse<T = unknown> {
+    data?: T;
+    error?: GraphApiError;
+    paging?: Paging;
+}
+export interface GraphApiError {
+    message: string;
+    type: string;
+    code: number;
+    error_subcode?: number;
+    fbtrace_id?: string;
+}
+export interface Paging {
+    cursors?: {
+        before?: string;
+        after?: string;
+    };
+    next?: string;
+    previous?: string;
+}
+export interface FacebookUser {
+    id: string;
+    name?: string;
+    email?: string;
+    first_name?: string;
+    last_name?: string;
+    picture?: {
+        data: {
+            url: string;
+            width?: number;
+            height?: number;
+            is_silhouette?: boolean;
+        };
+    };
+    link?: string;
+    birthday?: string;
+    gender?: string;
+    hometown?: {
+        id: string;
+        name: string;
+    };
+    location?: {
+        id: string;
+        name: string;
+    };
+}
+export interface FacebookPost {
+    id: string;
+    message?: string;
+    story?: string;
+    created_time?: string;
+    updated_time?: string;
+    full_picture?: string;
+    picture?: string;
+    link?: string;
+    permalink_url?: string;
+    shares?: {
+        count: number;
+    };
+    likes?: {
+        summary: {
+            total_count: number;
+        };
+    };
+    comments?: {
+        summary: {
+            total_count: number;
+        };
+    };
+    from?: {
+        id: string;
+        name: string;
+    };
+    type?: string;
+    status_type?: string;
+}
+export interface PaginationInfo {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    pagination: PaginationInfo;
+}
+export interface ToolResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    summary?: Record<string, unknown>;
+    source?: string;
+    note?: string;
+    pagination?: PaginationInfo;
+}
+export interface DebugMetadata {
+    toolName: string;
+    toolInput: unknown;
+    toolCallTime: number;
+    timestamp: string;
+}
+export interface ToolResponse<T = unknown> {
+    data: T;
+    debug?: DebugMetadata;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for Facebook/Instagram MCP Server
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "bn-facebook-mcp-server",
+  "version": "0.0.1",
+  "description": "Stateless MCP Server for Facebook Graph API",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bn-facebook-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "node --watch dist/index.js",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "package": "docker build -t bn-facebook-mcp-server .",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "mcp",
+    "facebook",
+    "graph-api",
+    "user-data",
+    "stateless"
+  ],
+  "author": "BlueNexus AI",
+  "license": "PROPRIETARY",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "express": "^4.21.2",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.2",
+    "typescript": "^5.8.3",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE",
+    "tools.json"
+  ],
+  "packageManager": "pnpm@10.22.0"
+}