@hasna/brains 0.0.23 → 0.0.25

package/dist/mcp/http.d.ts

@@ -0,0 +1,17 @@
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare const DEFAULT_MCP_HTTP_PORT = 8802;
+export declare const MCP_HTTP_HOST = "127.0.0.1";
+export declare const MCP_SERVICE_NAME = "brains";
+export declare function isHttpMode(args: string[]): boolean;
+export declare function resolveMcpHttpPort(args: string[]): number;
+export declare function healthPayload(name?: string): {
+    status: string;
+    name: string;
+};
+export declare function handleMcpRequest(req: Request, buildServer: () => Server): Promise<Response>;
+export declare function startMcpHttpServer(options: {
+    name: string;
+    port: number;
+    buildServer: () => Server;
+}): ReturnType<typeof Bun.serve>;
+//# sourceMappingURL=http.d.ts.map

package/dist/mcp/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/mcp/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAExE,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,aAAa,cAAc,CAAC;AACzC,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAElD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAQzD;AAED,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAyB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAE/F;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,MAAM,MAAM,GACxB,OAAO,CAAC,QAAQ,CAAC,CAOnB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,MAAM,CAAC;CAC3B,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAoB/B"}

package/dist/mcp/index.d.ts

@@ -5,7 +5,7 @@ export declare const MCP_SERVER_INFO: {
     readonly name: "brains";
     readonly version: string;
 };
-export declare function createMcpServer(): Server<{
+export declare function buildServer(): Server<{
     method: string;
     params?: {
         [x: string]: unknown;
@@ -39,6 +39,8 @@ export declare function createMcpServer(): Server<{
         } | undefined;
     } | undefined;
 }>;
+/** @deprecated Use buildServer() */
+export declare const createMcpServer: typeof buildServer;
 export declare function startMcpServer(transport?: StdioServerTransport): Promise<Server<{
     method: string;
     params?: {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAqDjF,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AAEX,wBAAgB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6e9B;AAED,wBAAsB,cAAc,CAAC,SAAS,uBAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAW1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAsDjF,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AAEX,wBAAgB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmf1B;AAED,oCAAoC;AACpC,eAAO,MAAM,eAAe,oBAAc,CAAC;AAqB3C,wBAAsB,cAAc,CAAC,SAAS,uBAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAI1E"}

package/dist/mcp/index.js

@@ -24119,6 +24119,55 @@ var McpFinetuneStatusSchema = exports_external2.object({
   provider: ProviderSchema
 });
 
+// src/mcp/http.ts
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+var DEFAULT_MCP_HTTP_PORT = 8802;
+var MCP_HTTP_HOST = "127.0.0.1";
+var MCP_SERVICE_NAME = "brains";
+function isHttpMode(args) {
+  return args.includes("--http") || process.env.MCP_HTTP === "1";
+}
+function resolveMcpHttpPort(args) {
+  const portIdx = args.indexOf("--port");
+  if (portIdx >= 0 && args[portIdx + 1]) {
+    return Number(args[portIdx + 1]);
+  }
+  const envPort = process.env.MCP_HTTP_PORT;
+  if (envPort)
+    return Number(envPort);
+  return DEFAULT_MCP_HTTP_PORT;
+}
+function healthPayload(name = MCP_SERVICE_NAME) {
+  return { status: "ok", name };
+}
+async function handleMcpRequest(req, buildServer) {
+  const transport = new WebStandardStreamableHTTPServerTransport({
+    sessionIdGenerator: undefined
+  });
+  const server = buildServer();
+  await server.connect(transport);
+  return transport.handleRequest(req);
+}
+function startMcpHttpServer(options) {
+  const { name, port, buildServer } = options;
+  const server = Bun.serve({
+    hostname: MCP_HTTP_HOST,
+    port,
+    async fetch(req) {
+      const url = new URL(req.url);
+      if (url.pathname === "/health" && req.method === "GET") {
+        return Response.json(healthPayload(name));
+      }
+      if (url.pathname === "/mcp") {
+        return handleMcpRequest(req, buildServer);
+      }
+      return new Response("Not Found", { status: 404 });
+    }
+  });
+  console.error(`${name}-mcp HTTP listening on http://${MCP_HTTP_HOST}:${port}/mcp`);
+  return server;
+}
+
 // src/mcp/index.ts
 function getProvider(provider) {
   if (provider === "openai")
@@ -24148,7 +24197,7 @@ var MCP_SERVER_INFO = {
   name: "brains",
   version: getPackageVersion()
 };
-function createMcpServer() {
+function buildServer() {
   const server = new Server(MCP_SERVER_INFO, { capabilities: { tools: {} } });
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
@@ -24573,21 +24622,70 @@ function createMcpServer() {
       };
     }
   });
-  return server;
-}
-async function startMcpServer(transport = new StdioServerTransport) {
-  const server = createMcpServer();
   try {
     registerCloudTools(server, "brains");
   } catch {}
+  return server;
+}
+var createMcpServer = buildServer;
+function hasFlag(...flags) {
+  return process.argv.some((arg) => flags.includes(arg));
+}
+function printHelp() {
+  process.stdout.write(`Usage: brains-mcp [options]
+
+Brains MCP server (stdio transport by default)
+
+Options:
+  --http           Serve MCP over Streamable HTTP (127.0.0.1)
+  --port <number>  HTTP port (default: 8801, env: MCP_HTTP_PORT)
+  -h, --help       Show help
+  -V, --version    Show version
+`);
+}
+async function startMcpServer(transport = new StdioServerTransport) {
+  const server = buildServer();
   await server.connect(transport);
   return server;
 }
-if (import.meta.main) {
+async function main() {
+  if (hasFlag("--help", "-h")) {
+    printHelp();
+    return;
+  }
+  if (hasFlag("--version", "-V")) {
+    process.stdout.write(`${MCP_SERVER_INFO.version}
+`);
+    return;
+  }
+  const args = process.argv.slice(2);
+  if (isHttpMode(args)) {
+    const handle = startMcpHttpServer({
+      name: "brains",
+      port: resolveMcpHttpPort(args),
+      buildServer
+    });
+    process.on("SIGINT", () => {
+      handle.stop();
+      process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+      handle.stop();
+      process.exit(0);
+    });
+    return;
+  }
   await startMcpServer();
 }
+if (import.meta.main) {
+  main().catch((error) => {
+    console.error("MCP server error:", error);
+    process.exit(1);
+  });
+}
 export {
   startMcpServer,
   createMcpServer,
+  buildServer,
   MCP_SERVER_INFO
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/brains",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "Fine-tuned model tracker and trainer — wraps OpenAI + Thinker Labs, gathers training data from todos/mementos/conversations/sessions",
   "type": "module",
   "main": "./dist/index.js",