@littlebigbrain/mcp 0.2.0

package/dist/http.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { createMcpHttpServer } from "./http-server.js";
+const port = Number(process.env.PORT ?? 8080);
+if (!Number.isInteger(port) || port < 0 || port > 65_535) {
+    throw new Error("PORT must be an integer between 0 and 65535");
+}
+// Bind loopback by default; exposing the key-bearer edge to a network is an
+// explicit decision (LBB_MCP_HOST=0.0.0.0) that should sit behind your own
+// auth/edge. When bound to loopback, DNS-rebinding protection defaults to
+// loopback host names; override with LBB_MCP_ALLOWED_HOSTS /
+// LBB_MCP_ALLOWED_ORIGINS (comma-separated) when fronting it deliberately.
+const host = process.env.LBB_MCP_HOST ?? "127.0.0.1";
+const LOOPBACK_HOSTS = ["127.0.0.1", "localhost", "::1", "[::1]"];
+const isLoopback = LOOPBACK_HOSTS.includes(host);
+function csv(value) {
+    const items = value
+        ?.split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+    return items && items.length > 0 ? items : undefined;
+}
+const mcpPath = process.env.LBB_MCP_PATH ?? "/mcp";
+const httpServer = createMcpHttpServer({
+    baseUrl: process.env.LBB_BASE_URL ?? "https://db.eu.littlebigbrain.com",
+    mcpPath,
+    allowedHosts: csv(process.env.LBB_MCP_ALLOWED_HOSTS) ??
+        (isLoopback ? LOOPBACK_HOSTS : undefined),
+    allowedOrigins: csv(process.env.LBB_MCP_ALLOWED_ORIGINS),
+    onError: (error) => console.error(error),
+});
+httpServer.listen(port, host, () => {
+    console.error(`lbb MCP (streamable-http) listening on ${host}:${port}${mcpPath}`);
+});

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { registerLbbTools } from "./tools.js";
+export { buildLbbServer } from "./server.js";
+export { createMcpHttpServer, type McpHttpServerOptions, } from "./http-server.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { registerLbbTools } from "./tools.js";
+export { buildLbbServer } from "./server.js";
+export { createMcpHttpServer, } from "./http-server.js";

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LbbClient } from "@littlebigbrain/client";
+/** Build an MCP server exposing the Little Big Brain tool belt, bound to one client. */
+export declare function buildLbbServer(client: LbbClient): McpServer;

package/dist/server.js

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerLbbTools } from "./tools.js";
+/** Build an MCP server exposing the Little Big Brain tool belt, bound to one client. */
+export function buildLbbServer(client) {
+    const server = new McpServer({ name: "lbb", version: "0.1.0" });
+    registerLbbTools(server, client);
+    return server;
+}

package/dist/stdio.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { LbbClient } from "@littlebigbrain/client";
+import { buildLbbServer } from "./server.js";
+/**
+ * Local stdio entrypoint (`npx @littlebigbrain/mcp`). Reads the connection from the
+ * environment and serves the Little Big Brain tools over stdio, the transport every
+ * editor (Claude Code, Cursor, Codex) supports.
+ *
+ *   LBB_BASE_URL  (default http://127.0.0.1:7400)
+ *   LBB_API_KEY   stack API key (lbb_sk_live_…) or single-mode token
+ *   LBB_GRAPH / LBB_BRANCH  (optional; server defaults to main/main)
+ */
+async function main() {
+    const client = new LbbClient({
+        baseUrl: process.env.LBB_BASE_URL ?? "http://127.0.0.1:7400",
+        apiKey: process.env.LBB_API_KEY,
+        graph: process.env.LBB_GRAPH,
+        branch: process.env.LBB_BRANCH,
+    });
+    const server = buildLbbServer(client);
+    await server.connect(new StdioServerTransport());
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});