@exulu/backend 0.3.8 → 0.3.9

package/dist/index.cjs

@@ -1369,6 +1369,44 @@ var ExuluEval = class {
     }
   };
 };
+var calculateStatistics = (items, method) => {
+  let methodProperty = "";
+  if (method === "l1Distance") {
+    methodProperty = "l1_distance";
+  }
+  if (method === "l2Distance") {
+    methodProperty = "l2_distance";
+  }
+  if (method === "hammingDistance") {
+    methodProperty = "hamming_distance";
+  }
+  if (method === "jaccardDistance") {
+    methodProperty = "jaccard_distance";
+  }
+  if (method === "maxInnerProduct") {
+    methodProperty = "inner_product";
+  }
+  if (method === "cosineDistance") {
+    methodProperty = "cosine_distance";
+  }
+  const sorted = items.sort((a, b) => a[methodProperty] - b[methodProperty]);
+  const median = sorted[Math.floor(items.length / 2)];
+  const max = sorted[sorted.length - 1];
+  const min = sorted[0];
+  const average = items.reduce((acc, item) => {
+    return acc + item[methodProperty];
+  }, 0) / items.length;
+  const total = items.reduce((acc, item) => {
+    return acc + item[methodProperty];
+  }, 0);
+  return {
+    max,
+    min,
+    median,
+    average,
+    total
+  };
+};
 var ExuluTool = class {
   id;
   name;
@@ -1636,6 +1674,9 @@ var ExuluContext = class {
       };
     }
     if (typeof query === "string") {
+      if (!method) {
+        method = "cosineDistance";
+      }
       itemsQuery.limit(limit * 5);
       if (statistics) {
         updateStatistic({
@@ -1652,12 +1693,12 @@ var ExuluContext = class {
       itemsQuery.leftJoin(chunksTable, function() {
         this.on(chunksTable + ".source", "=", mainTable + ".id");
       });
-      itemsQuery.select(chunksTable + ".id");
+      itemsQuery.select(chunksTable + ".id as chunk_id");
       itemsQuery.select(chunksTable + ".source");
       itemsQuery.select(chunksTable + ".content");
       itemsQuery.select(chunksTable + ".chunk_index");
-      itemsQuery.select(chunksTable + ".created_at");
-      itemsQuery.select(chunksTable + ".updated_at");
+      itemsQuery.select(chunksTable + ".created_at as chunk_created_at");
+      itemsQuery.select(chunksTable + ".updated_at as chunk_updated_at");
       const { chunks } = await this.embedder.generateFromQuery(query);
       if (!chunks?.[0]?.vector) {
         throw new Error("No vector generated for query.");
@@ -1699,7 +1740,7 @@ var ExuluContext = class {
           seenSources.set(item.source, {
             ...Object.fromEntries(
               Object.keys(item).filter(
-                (key) => key !== "l1_distance" && key !== "l2_distance" && key !== "hamming_distance" && key !== "jaccard_distance" && key !== "inner_product" && key !== "cosine_distance" && key !== "content" && key !== "source" && key !== "chunk_index"
+                (key) => key !== "l1_distance" && key !== "l2_distance" && key !== "hamming_distance" && key !== "jaccard_distance" && key !== "inner_product" && key !== "cosine_distance" && key !== "content" && key !== "source" && key !== "chunk_index" && key !== "chunk_id" && key !== "chunk_created_at" && key !== "chunk_updated_at"
               ).map((key) => [key, item[key]])
             ),
             chunks: [{
@@ -1728,6 +1769,23 @@ var ExuluContext = class {
         }
         return acc;
       }, []);
+      items.forEach((item) => {
+        if (!item.chunks?.length) {
+          return;
+        }
+        const {
+          max,
+          min,
+          median,
+          average,
+          total
+        } = calculateStatistics(item.chunks, method ?? "cosineDistance");
+        item.maxRelevance = max;
+        item.minRelevance = min;
+        item.medianRelevance = median;
+        item.averageRelevance = average;
+        item.totalRelevance = total;
+      });
       if (this.resultReranker && query) {
         items = await this.resultReranker(items);
       }
@@ -1850,7 +1908,7 @@ var updateStatistic = async (statistic) => {
 };
 
 // src/registry/index.ts
-var import_express4 = require("express");
+var import_express6 = require("express");
 
 // src/registry/routes.ts
 var import_express2 = require("express");
@@ -3004,6 +3062,8 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
   const routeLogs = [];
   var corsOptions = {
     origin: "*",
+    exposedHeaders: "*",
+    allowedHeaders: "*",
     optionsSuccessStatus: 200
     // some legacy browsers (IE11, various SmartTVs) choke on 204
   };
@@ -3074,7 +3134,7 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
   console.log("[EXULU] graphql server started");
   app.use(
     "/graphql",
-    (0, import_cors.default)(),
+    (0, import_cors.default)(corsOptions),
     import_express3.default.json(),
     (0, import_express5.expressMiddleware)(server, {
       context: async ({ req }) => {
@@ -3185,7 +3245,7 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
     }
     const item = await query.first();
     if (!item) {
-      throw new Error("Item not found.");
+      return null;
     }
     const chunks = await db2.from(context.getChunksTableName()).where({ source: item.id }).select("id");
     if (chunks.length > 0) {
@@ -3206,6 +3266,12 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
       id: req.params.id,
       contextId: req.params.context
     });
+    if (!result) {
+      res.status(200).json({
+        message: "Item not found."
+      });
+      return;
+    }
     res.status(200).json(result);
   });
   app.delete("/items/:context/external/:id", async (req, res) => {
@@ -3219,6 +3285,12 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
       external_id: req.params.id,
       contextId: req.params.context
     });
+    if (!result) {
+      res.status(200).json({
+        message: "Item not found."
+      });
+      return;
+    }
     res.status(200).json(result);
   });
   app.get("/items/:context/:id", async (req, res) => {
@@ -3915,6 +3987,7 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
   }
   console.log("Routes:");
   console.table(routeLogs);
+  return app;
 };
 var preprocessInputs = async (data) => {
   for (const key in data) {
@@ -4164,16 +4237,160 @@ var createLogsCleanerWorker = (logsDir) => {
   return logsCleaner;
 };
 
+// src/mcp/index.ts
+var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var import_node_crypto = require("crypto");
+var import_streamableHttp = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+var import_types = require("@modelcontextprotocol/sdk/types.js");
+var import_zod3 = require("zod");
+var import_express4 = require("express");
+var ExuluMCP = class {
+  server;
+  transports = {};
+  express;
+  constructor() {
+  }
+  create = async ({ express: express2, contexts, embedders, agents, workflows, config, tools }) => {
+    this.express = express2;
+    if (!this.server) {
+      console.log("[EXULU] Creating MCP server.");
+      this.server = new import_mcp.McpServer({
+        name: "exulu-mcp-server",
+        version: "1.0.0"
+      });
+    }
+    this.server.registerTool(
+      "add",
+      {
+        title: "Addition Tool",
+        description: "Add two numbers",
+        inputSchema: { a: import_zod3.z.number(), b: import_zod3.z.number() }
+      },
+      async ({ a, b }) => ({
+        content: [{ type: "text", text: String(a + b) }]
+      })
+    );
+    this.server.registerResource(
+      "greeting",
+      new import_mcp.ResourceTemplate("greeting://{name}", { list: void 0 }),
+      {
+        title: "Greeting Resource",
+        // Display name for UI
+        description: "Dynamic greeting generator"
+      },
+      async (uri, { name }) => ({
+        contents: [{
+          uri: uri.href,
+          text: `Hello, ${name}!`
+        }]
+      })
+    );
+    this.server.registerPrompt(
+      "review-code",
+      {
+        title: "Code Review",
+        description: "Review code for best practices and potential issues",
+        argsSchema: { code: import_zod3.z.string() }
+      },
+      ({ code }) => ({
+        messages: [{
+          role: "user",
+          content: {
+            type: "text",
+            text: `Please review this code:
+
+${code}`
+          }
+        }]
+      })
+    );
+    console.log("Contexts:");
+    console.table();
+  };
+  connect = async () => {
+    if (!this.express) {
+      throw new Error("Express not initialized.");
+    }
+    if (!this.server) {
+      throw new Error("MCP server not initialized.");
+    }
+    console.log("[EXULU] Wiring up MCP server routes to express app.");
+    this.express.post("/mcp", async (req, res) => {
+      const sessionId = req.headers["mcp-session-id"];
+      let transport;
+      if (sessionId && this.transports[sessionId]) {
+        transport = this.transports[sessionId];
+      } else if (!sessionId && (0, import_types.isInitializeRequest)(req.body)) {
+        transport = new import_streamableHttp.StreamableHTTPServerTransport({
+          sessionIdGenerator: () => (0, import_node_crypto.randomUUID)(),
+          onsessioninitialized: (sessionId2) => {
+            this.transports[sessionId2] = transport;
+          }
+          // DNS rebinding protection is disabled by default for backwards compatibility. If you are running this server
+          // locally, make sure to set:
+          // enableDnsRebindingProtection: true,
+          // allowedHosts: ['127.0.0.1'],
+        });
+        transport.onclose = () => {
+          if (transport.sessionId) {
+            delete this.transports[transport.sessionId];
+          }
+        };
+        const server = new import_mcp.McpServer({
+          name: "example-server",
+          version: "1.0.0"
+        });
+        await server.connect(transport);
+      } else {
+        res.status(400).json({
+          jsonrpc: "2.0",
+          error: {
+            code: -32e3,
+            message: "Bad Request: No valid session ID provided"
+          },
+          id: null
+        });
+        return;
+      }
+      await transport.handleRequest(req, res, req.body);
+    });
+    const handleSessionRequest = async (req, res) => {
+      const sessionId = req.headers["mcp-session-id"];
+      if (!sessionId || !this.transports[sessionId]) {
+        res.status(400).send("Invalid or missing session ID");
+        return;
+      }
+      const transport = this.transports[sessionId];
+      await transport.handleRequest(req, res);
+    };
+    this.express.get("/mcp", handleSessionRequest);
+    this.express.delete("/mcp", handleSessionRequest);
+    const routeLogs = [];
+    routeLogs.push(
+      { route: "/mcp", method: "GET", note: "Get MCP server status" },
+      { route: "/mcp", method: "POST", note: "Send MCP request" },
+      { route: "/mcp", method: "DELETE", note: "Terminate MCP session" }
+    );
+    console.log("MCP Routes:");
+    console.table(routeLogs);
+    return this.express;
+  };
+};
+
 // src/registry/index.ts
 var ExuluApp = class {
-  _agents;
-  _workflows;
+  _agents = [];
+  _workflows = [];
   _config;
-  _embedders;
+  _embedders = [];
   _queues = [];
-  _contexts;
-  _tools;
-  constructor({ contexts, embedders, agents, workflows, config, tools }) {
+  _contexts = {};
+  _tools = [];
+  constructor() {
+  }
+  // Factory function so we can async initialize the
+  // MCP server if needed.
+  create = async ({ contexts, embedders, agents, workflows, config, tools }) => {
     this._embedders = embedders ?? [];
     this._workflows = workflows ?? [];
     this._contexts = contexts ?? {};
@@ -4185,7 +4402,7 @@ var ExuluApp = class {
       ...workflows?.length ? workflows.map((workflow) => workflow.queue?.name || null) : []
     ];
     this._queues = [...new Set(queues2.filter((o) => !!o))];
-  }
+  };
   embedder(id) {
     return this._embedders.find((x) => x.id === id);
   }
@@ -4224,7 +4441,7 @@ var ExuluApp = class {
           Object.values(this._contexts ?? {}),
           this._embedders,
           this._workflows,
-          this._config.workers?.logsDir
+          this._config?.workers?.logsDir
         );
       }
     }
@@ -4232,7 +4449,7 @@ var ExuluApp = class {
   server = {
     express: {
       init: async (app) => {
-        return await createExpressRoutes(
+        await createExpressRoutes(
           app,
           this._agents,
           this._embedders,
@@ -4240,6 +4457,20 @@ var ExuluApp = class {
           this._workflows,
           Object.values(this._contexts ?? {})
         );
+        if (this._config?.MCP.enabled) {
+          const mcp = new ExuluMCP();
+          await mcp.create({
+            express: app,
+            contexts: this._contexts,
+            embedders: this._embedders,
+            agents: this._agents,
+            workflows: this._workflows,
+            config: this._config,
+            tools: this._tools
+          });
+          await mcp.connect();
+        }
+        return app;
       }
     }
   };

package/dist/index.d.cts

@@ -457,23 +457,27 @@ type ExuluConfig = {
         enabled: boolean;
         logsDir?: string;
     };
+    MCP: {
+        enabled: boolean;
+    };
 };
 declare class ExuluApp {
     private _agents;
     private _workflows;
-    private _config;
+    private _config?;
     private _embedders;
     private _queues;
     private _contexts?;
     private _tools;
-    constructor({ contexts, embedders, agents, workflows, config, tools }: {
+    constructor();
+    create: ({ contexts, embedders, agents, workflows, config, tools }: {
         contexts?: Record<string, ExuluContext>;
         config: ExuluConfig;
         embedders?: ExuluEmbedder[];
         agents?: ExuluAgent[];
         workflows?: ExuluWorkflow[];
         tools?: ExuluTool[];
-    });
+    }) => Promise<void>;
     embedder(id: string): ExuluEmbedder | undefined;
     tool(id: string): ExuluTool | undefined;
     tools(): ExuluTool[];
@@ -491,7 +495,7 @@ declare class ExuluApp {
     };
     server: {
         express: {
-            init: (app: Express) => Promise<void>;
+            init: (app: Express) => Promise<Express>;
         };
     };
 }

package/dist/index.d.ts

@@ -457,23 +457,27 @@ type ExuluConfig = {
         enabled: boolean;
         logsDir?: string;
     };
+    MCP: {
+        enabled: boolean;
+    };
 };
 declare class ExuluApp {
     private _agents;
     private _workflows;
-    private _config;
+    private _config?;
     private _embedders;
     private _queues;
     private _contexts?;
     private _tools;
-    constructor({ contexts, embedders, agents, workflows, config, tools }: {
+    constructor();
+    create: ({ contexts, embedders, agents, workflows, config, tools }: {
         contexts?: Record<string, ExuluContext>;
         config: ExuluConfig;
         embedders?: ExuluEmbedder[];
         agents?: ExuluAgent[];
         workflows?: ExuluWorkflow[];
         tools?: ExuluTool[];
-    });
+    }) => Promise<void>;
     embedder(id: string): ExuluEmbedder | undefined;
     tool(id: string): ExuluTool | undefined;
     tools(): ExuluTool[];
@@ -491,7 +495,7 @@ declare class ExuluApp {
     };
     server: {
         express: {
-            init: (app: Express) => Promise<void>;
+            init: (app: Express) => Promise<Express>;
         };
     };
 }

package/dist/index.js

@@ -1325,6 +1325,44 @@ var ExuluEval = class {
     }
   };
 };
+var calculateStatistics = (items, method) => {
+  let methodProperty = "";
+  if (method === "l1Distance") {
+    methodProperty = "l1_distance";
+  }
+  if (method === "l2Distance") {
+    methodProperty = "l2_distance";
+  }
+  if (method === "hammingDistance") {
+    methodProperty = "hamming_distance";
+  }
+  if (method === "jaccardDistance") {
+    methodProperty = "jaccard_distance";
+  }
+  if (method === "maxInnerProduct") {
+    methodProperty = "inner_product";
+  }
+  if (method === "cosineDistance") {
+    methodProperty = "cosine_distance";
+  }
+  const sorted = items.sort((a, b) => a[methodProperty] - b[methodProperty]);
+  const median = sorted[Math.floor(items.length / 2)];
+  const max = sorted[sorted.length - 1];
+  const min = sorted[0];
+  const average = items.reduce((acc, item) => {
+    return acc + item[methodProperty];
+  }, 0) / items.length;
+  const total = items.reduce((acc, item) => {
+    return acc + item[methodProperty];
+  }, 0);
+  return {
+    max,
+    min,
+    median,
+    average,
+    total
+  };
+};
 var ExuluTool = class {
   id;
   name;
@@ -1592,6 +1630,9 @@ var ExuluContext = class {
       };
     }
     if (typeof query === "string") {
+      if (!method) {
+        method = "cosineDistance";
+      }
       itemsQuery.limit(limit * 5);
       if (statistics) {
         updateStatistic({
@@ -1608,12 +1649,12 @@ var ExuluContext = class {
       itemsQuery.leftJoin(chunksTable, function() {
         this.on(chunksTable + ".source", "=", mainTable + ".id");
       });
-      itemsQuery.select(chunksTable + ".id");
+      itemsQuery.select(chunksTable + ".id as chunk_id");
       itemsQuery.select(chunksTable + ".source");
       itemsQuery.select(chunksTable + ".content");
       itemsQuery.select(chunksTable + ".chunk_index");
-      itemsQuery.select(chunksTable + ".created_at");
-      itemsQuery.select(chunksTable + ".updated_at");
+      itemsQuery.select(chunksTable + ".created_at as chunk_created_at");
+      itemsQuery.select(chunksTable + ".updated_at as chunk_updated_at");
       const { chunks } = await this.embedder.generateFromQuery(query);
       if (!chunks?.[0]?.vector) {
         throw new Error("No vector generated for query.");
@@ -1655,7 +1696,7 @@ var ExuluContext = class {
           seenSources.set(item.source, {
             ...Object.fromEntries(
               Object.keys(item).filter(
-                (key) => key !== "l1_distance" && key !== "l2_distance" && key !== "hamming_distance" && key !== "jaccard_distance" && key !== "inner_product" && key !== "cosine_distance" && key !== "content" && key !== "source" && key !== "chunk_index"
+                (key) => key !== "l1_distance" && key !== "l2_distance" && key !== "hamming_distance" && key !== "jaccard_distance" && key !== "inner_product" && key !== "cosine_distance" && key !== "content" && key !== "source" && key !== "chunk_index" && key !== "chunk_id" && key !== "chunk_created_at" && key !== "chunk_updated_at"
               ).map((key) => [key, item[key]])
             ),
             chunks: [{
@@ -1684,6 +1725,23 @@ var ExuluContext = class {
         }
         return acc;
       }, []);
+      items.forEach((item) => {
+        if (!item.chunks?.length) {
+          return;
+        }
+        const {
+          max,
+          min,
+          median,
+          average,
+          total
+        } = calculateStatistics(item.chunks, method ?? "cosineDistance");
+        item.maxRelevance = max;
+        item.minRelevance = min;
+        item.medianRelevance = median;
+        item.averageRelevance = average;
+        item.totalRelevance = total;
+      });
       if (this.resultReranker && query) {
         items = await this.resultReranker(items);
       }
@@ -2960,6 +3018,8 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
   const routeLogs = [];
   var corsOptions = {
     origin: "*",
+    exposedHeaders: "*",
+    allowedHeaders: "*",
     optionsSuccessStatus: 200
     // some legacy browsers (IE11, various SmartTVs) choke on 204
   };
@@ -3030,7 +3090,7 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
   console.log("[EXULU] graphql server started");
   app.use(
     "/graphql",
-    cors(),
+    cors(corsOptions),
     express.json(),
     expressMiddleware(server, {
       context: async ({ req }) => {
@@ -3141,7 +3201,7 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
     }
     const item = await query.first();
     if (!item) {
-      throw new Error("Item not found.");
+      return null;
     }
     const chunks = await db2.from(context.getChunksTableName()).where({ source: item.id }).select("id");
     if (chunks.length > 0) {
@@ -3162,6 +3222,12 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
       id: req.params.id,
       contextId: req.params.context
     });
+    if (!result) {
+      res.status(200).json({
+        message: "Item not found."
+      });
+      return;
+    }
     res.status(200).json(result);
   });
   app.delete("/items/:context/external/:id", async (req, res) => {
@@ -3175,6 +3241,12 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
       external_id: req.params.id,
       contextId: req.params.context
     });
+    if (!result) {
+      res.status(200).json({
+        message: "Item not found."
+      });
+      return;
+    }
     res.status(200).json(result);
   });
   app.get("/items/:context/:id", async (req, res) => {
@@ -3871,6 +3943,7 @@ var createExpressRoutes = async (app, agents, embedders, tools, workflows, conte
   }
   console.log("Routes:");
   console.table(routeLogs);
+  return app;
 };
 var preprocessInputs = async (data) => {
   for (const key in data) {
@@ -4120,16 +4193,160 @@ var createLogsCleanerWorker = (logsDir) => {
   return logsCleaner;
 };
 
+// src/mcp/index.ts
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { randomUUID } from "crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { z as z2 } from "zod";
+import "express";
+var ExuluMCP = class {
+  server;
+  transports = {};
+  express;
+  constructor() {
+  }
+  create = async ({ express: express2, contexts, embedders, agents, workflows, config, tools }) => {
+    this.express = express2;
+    if (!this.server) {
+      console.log("[EXULU] Creating MCP server.");
+      this.server = new McpServer({
+        name: "exulu-mcp-server",
+        version: "1.0.0"
+      });
+    }
+    this.server.registerTool(
+      "add",
+      {
+        title: "Addition Tool",
+        description: "Add two numbers",
+        inputSchema: { a: z2.number(), b: z2.number() }
+      },
+      async ({ a, b }) => ({
+        content: [{ type: "text", text: String(a + b) }]
+      })
+    );
+    this.server.registerResource(
+      "greeting",
+      new ResourceTemplate("greeting://{name}", { list: void 0 }),
+      {
+        title: "Greeting Resource",
+        // Display name for UI
+        description: "Dynamic greeting generator"
+      },
+      async (uri, { name }) => ({
+        contents: [{
+          uri: uri.href,
+          text: `Hello, ${name}!`
+        }]
+      })
+    );
+    this.server.registerPrompt(
+      "review-code",
+      {
+        title: "Code Review",
+        description: "Review code for best practices and potential issues",
+        argsSchema: { code: z2.string() }
+      },
+      ({ code }) => ({
+        messages: [{
+          role: "user",
+          content: {
+            type: "text",
+            text: `Please review this code:
+
+${code}`
+          }
+        }]
+      })
+    );
+    console.log("Contexts:");
+    console.table();
+  };
+  connect = async () => {
+    if (!this.express) {
+      throw new Error("Express not initialized.");
+    }
+    if (!this.server) {
+      throw new Error("MCP server not initialized.");
+    }
+    console.log("[EXULU] Wiring up MCP server routes to express app.");
+    this.express.post("/mcp", async (req, res) => {
+      const sessionId = req.headers["mcp-session-id"];
+      let transport;
+      if (sessionId && this.transports[sessionId]) {
+        transport = this.transports[sessionId];
+      } else if (!sessionId && isInitializeRequest(req.body)) {
+        transport = new StreamableHTTPServerTransport({
+          sessionIdGenerator: () => randomUUID(),
+          onsessioninitialized: (sessionId2) => {
+            this.transports[sessionId2] = transport;
+          }
+          // DNS rebinding protection is disabled by default for backwards compatibility. If you are running this server
+          // locally, make sure to set:
+          // enableDnsRebindingProtection: true,
+          // allowedHosts: ['127.0.0.1'],
+        });
+        transport.onclose = () => {
+          if (transport.sessionId) {
+            delete this.transports[transport.sessionId];
+          }
+        };
+        const server = new McpServer({
+          name: "example-server",
+          version: "1.0.0"
+        });
+        await server.connect(transport);
+      } else {
+        res.status(400).json({
+          jsonrpc: "2.0",
+          error: {
+            code: -32e3,
+            message: "Bad Request: No valid session ID provided"
+          },
+          id: null
+        });
+        return;
+      }
+      await transport.handleRequest(req, res, req.body);
+    });
+    const handleSessionRequest = async (req, res) => {
+      const sessionId = req.headers["mcp-session-id"];
+      if (!sessionId || !this.transports[sessionId]) {
+        res.status(400).send("Invalid or missing session ID");
+        return;
+      }
+      const transport = this.transports[sessionId];
+      await transport.handleRequest(req, res);
+    };
+    this.express.get("/mcp", handleSessionRequest);
+    this.express.delete("/mcp", handleSessionRequest);
+    const routeLogs = [];
+    routeLogs.push(
+      { route: "/mcp", method: "GET", note: "Get MCP server status" },
+      { route: "/mcp", method: "POST", note: "Send MCP request" },
+      { route: "/mcp", method: "DELETE", note: "Terminate MCP session" }
+    );
+    console.log("MCP Routes:");
+    console.table(routeLogs);
+    return this.express;
+  };
+};
+
 // src/registry/index.ts
 var ExuluApp = class {
-  _agents;
-  _workflows;
+  _agents = [];
+  _workflows = [];
   _config;
-  _embedders;
+  _embedders = [];
   _queues = [];
-  _contexts;
-  _tools;
-  constructor({ contexts, embedders, agents, workflows, config, tools }) {
+  _contexts = {};
+  _tools = [];
+  constructor() {
+  }
+  // Factory function so we can async initialize the
+  // MCP server if needed.
+  create = async ({ contexts, embedders, agents, workflows, config, tools }) => {
     this._embedders = embedders ?? [];
     this._workflows = workflows ?? [];
     this._contexts = contexts ?? {};
@@ -4141,7 +4358,7 @@ var ExuluApp = class {
       ...workflows?.length ? workflows.map((workflow) => workflow.queue?.name || null) : []
     ];
     this._queues = [...new Set(queues2.filter((o) => !!o))];
-  }
+  };
   embedder(id) {
     return this._embedders.find((x) => x.id === id);
   }
@@ -4180,7 +4397,7 @@ var ExuluApp = class {
           Object.values(this._contexts ?? {}),
           this._embedders,
           this._workflows,
-          this._config.workers?.logsDir
+          this._config?.workers?.logsDir
         );
       }
     }
@@ -4188,7 +4405,7 @@ var ExuluApp = class {
   server = {
     express: {
       init: async (app) => {
-        return await createExpressRoutes(
+        await createExpressRoutes(
           app,
           this._agents,
           this._embedders,
@@ -4196,6 +4413,20 @@ var ExuluApp = class {
           this._workflows,
           Object.values(this._contexts ?? {})
         );
+        if (this._config?.MCP.enabled) {
+          const mcp = new ExuluMCP();
+          await mcp.create({
+            express: app,
+            contexts: this._contexts,
+            embedders: this._embedders,
+            agents: this._agents,
+            workflows: this._workflows,
+            config: this._config,
+            tools: this._tools
+          });
+          await mcp.connect();
+        }
+        return app;
       }
     }
   };

package/ngrok.bash

@@ -0,0 +1 @@
+ngrok start --all --config ./ngrok.yml

package/ngrok.md

@@ -0,0 +1,6 @@
+To run ngrok so a cloud based client such as ChatGPT or Anthropic Claude can connect to your local MCP
+run the command:
+
+```bash
+ngrok start --all --config ./ngrok.yml
+```

package/ngrok.yml

@@ -0,0 +1,10 @@
+version: "2"
+authtoken: 1bDq4H21OulxgyopkEHZ5eH3Psh_6aNDpzDuBCTCVjtK7nMNx
+tunnels:
+    backend:
+        #host_header: "rewrite"
+        #response_header:
+            #add: ["Access-Control-Allow-Origin: *"]
+        proto: http
+        addr: 9001
+        domain: exulu.ngrok.app

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@exulu/backend",
     "author": "Qventu Bv.",
-    "version": "0.3.8",
+    "version": "0.3.9",
     "main": "./dist/index.js",
     "private": false,
     "publishConfig": {
@@ -41,6 +41,7 @@
         "@aws-sdk/client-sts": "^3.338.0",
         "@aws-sdk/s3-request-presigner": "^3.338.0",
         "@inkjs/ui": "^2.0.0",
+        "@modelcontextprotocol/sdk": "^1.14.0",
         "@panva/hkdf": "^1.2.1",
         "@types/bcrypt": "^5.0.2",
         "@types/cors": "^2.8.18",