bn-facebook-mcp-server 0.0.1

package/dist/index.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * Facebook MCP Server
+ *
+ * A stateless Model Context Protocol server for Facebook Graph API
+ * using Bearer token authentication.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import express from "express";
+import { z } from "zod";
+// Import schemas
+import { GetMeSchema, GetFriendsSchema, GetPhotosSchema, GetUserPostsSchema, GetVideosSchema, GetLikesSchema, GetPermissionsSchema, } from "./schemas.js";
+// Import tool handlers
+import { getMe, getFriends, getPhotos, getUserPosts, getVideos, getLikes, getPermissions, } from "./tools/index.js";
+// Import tool loader
+import { loadToolDefinitions } from "./tool-loader.js";
+// Import tool registry
+import { ToolRegistry } from "./tool-registry.js";
+// Import debug mode flag
+import { DEBUG_MODE } from "./debug-middleware.js";
+// Create tool registry and register all tools
+const toolRegistry = new ToolRegistry();
+// Register User tools (7)
+toolRegistry.register("get_me", GetMeSchema, getMe);
+toolRegistry.register("get_friends", GetFriendsSchema, getFriends);
+toolRegistry.register("get_photos", GetPhotosSchema, getPhotos);
+toolRegistry.register("get_user_posts", GetUserPostsSchema, getUserPosts);
+toolRegistry.register("get_videos", GetVideosSchema, getVideos);
+toolRegistry.register("get_likes", GetLikesSchema, getLikes);
+toolRegistry.register("get_permissions", GetPermissionsSchema, getPermissions);
+// Create MCP server
+const server = new Server({
+    name: "facebook-mcp-server",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Register tool handlers
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    // Load tool definitions from JSON (reloads on each request in dev mode)
+    const toolDefinitions = loadToolDefinitions();
+    return {
+        tools: toolDefinitions,
+    };
+});
+// Store current request in context (set during HTTP request handling)
+let currentRequest = null;
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (!currentRequest) {
+        throw new Error("No request context available. This server must be called via HTTP transport.");
+    }
+    try {
+        // Execute tool via registry (includes automatic validation and debug wrapping)
+        const result = await toolRegistry.execute(request.params.name, request.params.arguments, currentRequest);
+        // Return formatted response with data and optional debug info
+        // Debug info is included in the response when DEBUG mode is enabled
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            throw new Error(`Invalid arguments: ${error.message}`);
+        }
+        throw error;
+    }
+});
+// Create Express app with stateless HTTP transport
+const app = express();
+app.use(express.json());
+// Create stateless transport (no session management)
+const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: undefined, // Stateless mode
+    enableJsonResponse: true,
+});
+// Connect server to transport
+await server.connect(transport);
+// Handle MCP requests
+app.post("/mcp", async (req, res) => {
+    try {
+        // Store request in context for tool handlers to access headers
+        currentRequest = req;
+        await transport.handleRequest(req, res, req.body);
+        currentRequest = null; // Clear context after request
+    }
+    catch (error) {
+        currentRequest = null; // Clear context on error
+        console.error("Error handling MCP request:", error);
+        res.status(500).json({
+            error: "Internal server error",
+            message: error instanceof Error ? error.message : "Unknown error",
+        });
+    }
+});
+// Health check endpoint
+app.get("/health", (_req, res) => {
+    res.json({
+        status: "healthy",
+        server: "facebook-mcp-server",
+        version: "1.0.0",
+        stateless: true,
+        debug: DEBUG_MODE,
+        registeredTools: toolRegistry.getToolNames(),
+        categories: {
+            user: 7,
+        },
+    });
+});
+// Start server
+const PORT = process.env.PORT || 30003;
+app.listen(PORT, () => {
+    console.log(`Facebook MCP Server running on http://localhost:${PORT}`);
+    console.log(`MCP endpoint: http://localhost:${PORT}/mcp`);
+    console.log(`Health check: http://localhost:${PORT}/health`);
+    console.log("Mode: Stateless (no session management)");
+    console.log("Authentication: Bearer token required");
+    console.log(`Debug mode: ${DEBUG_MODE ? "ENABLED" : "DISABLED"}`);
+    console.log(`Total tools: ${toolRegistry.getToolNames().length}`);
+    if (DEBUG_MODE) {
+        console.log(`Registered tools: ${toolRegistry.getToolNames().join(", ")}`);
+    }
+});
+//# 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;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAClE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAA;AAClG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,OAAyB,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,cAAc,CAAA;AAErB,uBAAuB;AACvB,OAAO,EACL,KAAK,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,cAAc,GACf,MAAM,kBAAkB,CAAA;AAEzB,qBAAqB;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAEtD,uBAAuB;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,8CAA8C;AAC9C,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;AAEvC,0BAA0B;AAC1B,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC,CAAA;AACnD,YAAY,CAAC,QAAQ,CAAC,aAAa,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAA;AAClE,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,eAAe,EAAE,SAAS,CAAC,CAAA;AAC/D,YAAY,CAAC,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAA;AACzE,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,eAAe,EAAE,SAAS,CAAC,CAAA;AAC/D,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAA;AAC5D,YAAY,CAAC,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,CAAC,CAAA;AAE9E,oBAAoB;AACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAA;AAED,yBAAyB;AACzB,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,wEAAwE;IACxE,MAAM,eAAe,GAAG,mBAAmB,EAAE,CAAA;IAE7C,OAAO;QACL,KAAK,EAAE,eAAe;KACvB,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,sEAAsE;AACtE,IAAI,cAAc,GAAmB,IAAI,CAAA;AAEzC,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAA;IACH,CAAC;IAED,IAAI,CAAC;QACH,+EAA+E;QAC/E,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CACvC,OAAO,CAAC,MAAM,CAAC,IAAI,EACnB,OAAO,CAAC,MAAM,CAAC,SAAS,EACxB,cAAc,CACf,CAAA;QAED,8DAA8D;QAC9D,oEAAoE;QACpE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACxD,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAC,CAAA;AAEF,mDAAmD;AACnD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAA;AACrB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AAEvB,qDAAqD;AACrD,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;IAClD,kBAAkB,EAAE,SAAS,EAAE,iBAAiB;IAChD,kBAAkB,EAAE,IAAI;CACzB,CAAC,CAAA;AAEF,8BAA8B;AAC9B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AAE/B,sBAAsB;AACtB,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAClC,IAAI,CAAC;QACH,+DAA+D;QAC/D,cAAc,GAAG,GAAG,CAAA;QACpB,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;QACjD,cAAc,GAAG,IAAI,CAAA,CAAC,8BAA8B;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAc,GAAG,IAAI,CAAA,CAAC,yBAAyB;QAC/C,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAA;QACnD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,KAAK,EAAE,uBAAuB;YAC9B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAClE,CAAC,CAAA;IACJ,CAAC;AACH,CAAC,CAAC,CAAA;AAEF,wBAAwB;AACxB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;IAC/B,GAAG,CAAC,IAAI,CAAC;QACP,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,UAAU;QACjB,eAAe,EAAE,YAAY,CAAC,YAAY,EAAE;QAC5C,UAAU,EAAE;YACV,IAAI,EAAE,CAAC;SACR;KACF,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,eAAe;AACf,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,CAAA;AACtC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACpB,OAAO,CAAC,GAAG,CAAC,mDAAmD,IAAI,EAAE,CAAC,CAAA;IACtE,OAAO,CAAC,GAAG,CAAC,kCAAkC,IAAI,MAAM,CAAC,CAAA;IACzD,OAAO,CAAC,GAAG,CAAC,kCAAkC,IAAI,SAAS,CAAC,CAAA;IAC5D,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAA;IACtD,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAA;IACpD,OAAO,CAAC,GAAG,CAAC,eAAe,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAA;IACjE,OAAO,CAAC,GAAG,CAAC,gBAAgB,YAAY,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;IACjE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,qBAAqB,YAAY,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/schemas.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Zod schemas for Facebook/Instagram MCP Server tools
+ *
+ * Each schema includes comprehensive .describe() documentation for LLM-friendly usage.
+ * Descriptions include: use cases, examples, parameter relationships, and best practices.
+ */
+import { z } from "zod";
+export declare const GetMeSchema: z.ZodObject<{
+    fields: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    fields?: string | undefined;
+}, {
+    fields?: string | undefined;
+}>;
+export declare const GetFriendsSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    fields: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    page: number;
+    fields?: string | undefined;
+}, {
+    fields?: string | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
+}>;
+export declare const GetPhotosSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    fields: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    page: number;
+    fields?: string | undefined;
+}, {
+    fields?: string | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
+}>;
+export declare const GetUserPostsSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    fields: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    page: number;
+    fields?: string | undefined;
+}, {
+    fields?: string | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
+}>;
+export declare const GetVideosSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    fields: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    page: number;
+    fields?: string | undefined;
+}, {
+    fields?: string | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
+}>;
+export declare const GetLikesSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    fields: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    page: number;
+    fields?: string | undefined;
+}, {
+    fields?: string | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
+}>;
+export declare const GetPermissionsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,eAAO,MAAM,WAAW;;;;;;EAyBtB,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAkC3B,CAAA;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;EA0B1B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EA2B7B,CAAA;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;EA2B1B,CAAA;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;EAyBzB,CAAA;AAEF,eAAO,MAAM,oBAAoB,gDAsBhC,CAAA"}

package/dist/schemas.js

@@ -0,0 +1,170 @@
+/**
+ * Zod schemas for Facebook/Instagram MCP Server tools
+ *
+ * Each schema includes comprehensive .describe() documentation for LLM-friendly usage.
+ * Descriptions include: use cases, examples, parameter relationships, and best practices.
+ */
+import { z } from "zod";
+// ============================================================================
+// User Tools (7)
+// ============================================================================
+export const GetMeSchema = z.object({
+    fields: z.string().optional().describe(`Comma-separated list of user profile fields to retrieve.
+
+**Default Fields:**
+- id - User's Facebook ID
+- name - Full name
+- email - Primary email (requires email permission)
+- first_name, last_name - Name parts
+- picture - Profile picture URL
+
+**Additional Available Fields:**
+- birthday - Birth date (if permissions allow)
+- gender - Gender
+- hometown - Hometown info
+- location - Current city
+- link - Profile URL
+
+**Examples:**
+- Default: "id,name,email,first_name,last_name,picture.width(200).height(200)"
+- Minimal: "id,name"
+- Full: "id,name,email,first_name,last_name,picture,birthday,gender"
+
+**Note:** Some fields require additional permissions.`),
+});
+export const GetFriendsSchema = z.object({
+    page: z.number().optional().default(1).describe(`Page number to retrieve.
+
+**Default:** 1
+**Range:** 1 to unlimited
+
+**Usage:**
+- Page 1: First 25 friends (offset 0)
+- Page 2: Next 25 friends (offset 25)
+- Page 5: Friends 101-125 (offset 100)
+
+**Example:**
+First call: { page: 1, limit: 25 }
+Next call: { page: 2, limit: 25 }`),
+    limit: z.number().optional().default(25).describe(`Maximum number of friends to retrieve per page.
+
+**Default:** 25
+**Range:** 1 to 100
+
+**Note:** Only returns friends who also use the app.`),
+    fields: z.string().optional().describe(`Comma-separated list of friend fields.
+
+**Default:** "id,name,picture"
+
+**Available Fields:**
+- id - Friend's Facebook ID
+- name - Friend's name
+- picture - Profile picture URL`),
+});
+export const GetPhotosSchema = z.object({
+    page: z.number().optional().default(1).describe(`Page number to retrieve.
+
+**Default:** 1
+**Range:** 1 to unlimited`),
+    limit: z.number().optional().default(25).describe(`Maximum number of photos to retrieve per page.
+
+**Default:** 25
+**Range:** 1 to 100`),
+    fields: z.string().optional().describe(`Comma-separated list of photo fields.
+
+**Default:** "id,name,picture,created_time,link,images"
+
+**Available Fields:**
+- id - Photo ID
+- name - Photo caption/name
+- picture - Thumbnail URL
+- created_time - When uploaded
+- link - Photo URL
+- images - Array of image sizes`),
+});
+export const GetUserPostsSchema = z.object({
+    page: z.number().optional().default(1).describe(`Page number to retrieve.
+
+**Default:** 1
+**Range:** 1 to unlimited`),
+    limit: z.number().optional().default(25).describe(`Maximum number of posts to retrieve per page.
+
+**Default:** 25
+**Range:** 1 to 100`),
+    fields: z.string().optional().describe(`Comma-separated list of post fields.
+
+**Default:** "id,message,story,created_time,full_picture,permalink_url,shares,likes.summary(true),comments.summary(true)"
+
+**Available Fields:**
+- id - Post ID
+- message - Post text
+- story - Auto-generated story
+- created_time - When posted
+- full_picture - Image URL
+- permalink_url - Post link
+- shares, likes, comments - Engagement metrics`),
+});
+export const GetVideosSchema = z.object({
+    page: z.number().optional().default(1).describe(`Page number to retrieve.
+
+**Default:** 1
+**Range:** 1 to unlimited`),
+    limit: z.number().optional().default(25).describe(`Maximum number of videos to retrieve per page.
+
+**Default:** 25
+**Range:** 1 to 100`),
+    fields: z.string().optional().describe(`Comma-separated list of video fields.
+
+**Default:** "id,title,description,created_time,permalink_url,thumbnails,length"
+
+**Available Fields:**
+- id - Video ID
+- title - Video title
+- description - Video description
+- created_time - When uploaded
+- permalink_url - Video link
+- thumbnails - Thumbnail images
+- length - Duration in seconds`),
+});
+export const GetLikesSchema = z.object({
+    page: z.number().optional().default(1).describe(`Page number to retrieve.
+
+**Default:** 1
+**Range:** 1 to unlimited`),
+    limit: z.number().optional().default(25).describe(`Maximum number of liked pages to retrieve per page.
+
+**Default:** 25
+**Range:** 1 to 100`),
+    fields: z.string().optional().describe(`Comma-separated list of page fields.
+
+**Default:** "id,name,category,picture,fan_count"
+
+**Available Fields:**
+- id - Page ID
+- name - Page name
+- category - Page category
+- picture - Page profile picture
+- fan_count - Number of likes`),
+});
+export const GetPermissionsSchema = z.object({}).describe(`Get list of permissions granted to the current access token.
+
+**No parameters required.**
+
+**Returns:**
+Array of permission objects:
+- permission: Permission name (e.g., "email", "public_profile")
+- status: "granted" or "declined"
+
+**Use Cases:**
+- Verify what data you can access
+- Debug permission-related errors
+- Check if user granted required permissions
+
+**Common Permissions:**
+- public_profile - Basic profile info (always granted)
+- email - User's email address
+- pages_show_list - List user's Pages
+- pages_read_engagement - Read Page insights
+- instagram_basic - Basic Instagram info
+- instagram_content_publish - Post to Instagram`);
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/tool-loader.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tool configuration loader
+ * Loads tool definitions from tools.json and validates them
+ *
+ * Supports loading from (in priority order):
+ * 1. Custom path via TOOLS_CONFIG_PATH environment variable
+ * 2. tools.json in current working directory (for development)
+ * 3. tools.json in package installation directory (for npx/installed usage)
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface ToolsConfig {
+    [toolName: string]: ToolDefinition;
+}
+/**
+ * Load tool definitions from tools.json
+ * Uses caching in production, always reloads in development
+ */
+export declare function loadToolDefinitions(forceReload?: boolean): ToolDefinition[];
+/**
+ * Get a specific tool definition by name
+ */
+export declare function getToolDefinition(toolName: string): ToolDefinition | undefined;
+/**
+ * Clear the tool cache (useful for testing or forced reloads)
+ */
+export declare function clearToolCache(): void;
+//# sourceMappingURL=tool-loader.d.ts.map

package/dist/tool-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loader.d.ts","sourceRoot":"","sources":["../src/tool-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;CACF;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAA;CACnC;AAmDD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,UAAQ,GAAG,cAAc,EAAE,CAsEzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG9E;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAIrC"}

package/dist/tool-loader.js

@@ -0,0 +1,125 @@
+/**
+ * Tool configuration loader
+ * Loads tool definitions from tools.json and validates them
+ *
+ * Supports loading from (in priority order):
+ * 1. Custom path via TOOLS_CONFIG_PATH environment variable
+ * 2. tools.json in current working directory (for development)
+ * 3. tools.json in package installation directory (for npx/installed usage)
+ */
+import { readFileSync, existsSync } from "fs";
+import { resolve, isAbsolute, dirname } from "path";
+import { homedir } from "os";
+import { fileURLToPath } from "url";
+let cachedTools = null;
+let lastLoadTime = 0;
+let lastLoadPath = "";
+/**
+ * Resolve the tools configuration file path
+ * Supports:
+ * - Environment variable: TOOLS_CONFIG_PATH
+ * - Absolute paths: /Users/username/Desktop/tools.json
+ * - Relative paths: ./tools.json, ../config/tools.json
+ * - Home directory: ~/Desktop/tools.json
+ * - Default: tools.json in current working directory
+ * - Fallback: tools.json in package installation directory
+ */
+function resolveToolsPath() {
+    // Check environment variable first
+    const envPath = process.env.TOOLS_CONFIG_PATH;
+    if (envPath) {
+        // Expand ~ to home directory
+        const expandedPath = envPath.startsWith("~/")
+            ? resolve(homedir(), envPath.slice(2))
+            : envPath;
+        // If absolute path, use as-is
+        if (isAbsolute(expandedPath)) {
+            return expandedPath;
+        }
+        // Otherwise resolve relative to current working directory
+        return resolve(process.cwd(), expandedPath);
+    }
+    // Try current working directory first (for dev mode)
+    const cwdPath = resolve(process.cwd(), "tools.json");
+    if (existsSync(cwdPath)) {
+        return cwdPath;
+    }
+    // Fallback: tools.json in package installation directory (for npx/installed usage)
+    // Get the directory of this module file
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    // Go up from dist/tool-loader.js to package root
+    const packageRoot = resolve(moduleDir, "..");
+    const packagePath = resolve(packageRoot, "tools.json");
+    return packagePath;
+}
+/**
+ * Load tool definitions from tools.json
+ * Uses caching in production, always reloads in development
+ */
+export function loadToolDefinitions(forceReload = false) {
+    const isDev = process.env.NODE_ENV !== "production";
+    const now = Date.now();
+    // Get the tools config path
+    const toolsPath = resolveToolsPath();
+    // In production, cache tools and only reload if forced or path changed
+    // In development, reload every time (for nodemon compatibility)
+    if (!isDev &&
+        !forceReload &&
+        cachedTools &&
+        now - lastLoadTime < 60000 &&
+        lastLoadPath === toolsPath) {
+        return cachedTools;
+    }
+    try {
+        // Check if file exists
+        if (!existsSync(toolsPath)) {
+            throw new Error(`Tools configuration file not found: ${toolsPath}`);
+        }
+        const toolsJson = readFileSync(toolsPath, "utf-8");
+        const toolsConfig = JSON.parse(toolsJson);
+        // Convert config object to array of tool definitions
+        const tools = Object.values(toolsConfig);
+        // Validate tool definitions
+        for (const tool of tools) {
+            if (!tool.name || !tool.description || !tool.inputSchema) {
+                throw new Error(`Invalid tool definition: ${JSON.stringify(tool)}`);
+            }
+        }
+        cachedTools = tools;
+        lastLoadTime = now;
+        lastLoadPath = toolsPath;
+        console.log(`[Tool Loader] Loaded ${tools.length} tool definitions from: ${toolsPath}`);
+        if (isDev) {
+            console.log(`[Tool Loader] Development mode: tools will be reloaded on server restart`);
+        }
+        if (process.env.TOOLS_CONFIG_PATH) {
+            console.log(`[Tool Loader] Using custom config path from TOOLS_CONFIG_PATH`);
+        }
+        return tools;
+    }
+    catch (error) {
+        console.error("[Tool Loader] Error loading tools.json:", error);
+        // In case of error, return cached tools if available
+        if (cachedTools) {
+            console.warn("[Tool Loader] Using cached tool definitions due to load error");
+            return cachedTools;
+        }
+        throw new Error(`Failed to load tool definitions: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+}
+/**
+ * Get a specific tool definition by name
+ */
+export function getToolDefinition(toolName) {
+    const tools = loadToolDefinitions();
+    return tools.find((tool) => tool.name === toolName);
+}
+/**
+ * Clear the tool cache (useful for testing or forced reloads)
+ */
+export function clearToolCache() {
+    cachedTools = null;
+    lastLoadTime = 0;
+    console.log("[Tool Loader] Tool cache cleared");
+}
+//# sourceMappingURL=tool-loader.js.map

package/dist/tool-loader.js.map

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

package/dist/tool-registry.d.ts

@@ -0,0 +1,44 @@
+import type { Request } from "express";
+import type { z } from "zod";
+import type { ToolResponse } from "./types.js";
+type ToolHandler = (req: Request, args: unknown) => Promise<unknown>;
+type ToolSchema = z.ZodSchema<unknown>;
+/**
+ * Registry for managing and executing MCP tools with automatic debug wrapping
+ */
+export declare class ToolRegistry {
+    private tools;
+    /**
+     * 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: string, schema: ToolSchema, handler: ToolHandler): void;
+    /**
+     * 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
+     */
+    execute(toolName: string, rawInput: unknown, req: Request): Promise<ToolResponse<unknown>>;
+    /**
+     * 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: string): boolean;
+    /**
+     * Get all registered tool names
+     *
+     * @returns Array of registered tool names
+     */
+    getToolNames(): string[];
+}
+export {};
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAI9C,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AACpE,KAAK,UAAU,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;AAWtC;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAoC;IAEjD;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAItE;;;;;;;;OAQG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAcjC;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;OAIG;IACH,YAAY,IAAI,MAAM,EAAE;CAGzB"}