@kozou/mcp 0.0.1 → 0.1.1

package/dist/schemas/list_concepts.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const listConceptsInputSchema: z.ZodObject<{}, z.core.$strict>;
+export declare const listConceptsOutputSchema: z.ZodObject<{
+    concepts: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        kind: z.ZodLiteral<"VIEW">;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ListConceptsInput = z.infer<typeof listConceptsInputSchema>;
+export type ListConceptsOutput = z.infer<typeof listConceptsOutputSchema>;
+//# sourceMappingURL=list_concepts.d.ts.map

package/dist/schemas/list_concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_concepts.d.ts","sourceRoot":"","sources":["../../src/schemas/list_concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,uBAAuB,iCAAqB,CAAC;AAE1D,eAAO,MAAM,wBAAwB;;;;;;;iBASnC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/list_concepts.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+// No inputs; reject any extra fields. zod 4 infers a strict empty object as
+// `Record<string, never>`, so the tool fn takes the raw `Record<string,
+// unknown>` args and validates them through this schema rather than typing
+// its parameter as the inferred (and unassignable) empty-object type.
+export const listConceptsInputSchema = z.strictObject({});
+export const listConceptsOutputSchema = z.object({
+    concepts: z.array(z.object({
+        name: z.string(),
+        label: z.string(),
+        description: z.string().nullable(),
+        kind: z.literal('VIEW'),
+    })),
+});
+//# sourceMappingURL=list_concepts.js.map

package/dist/schemas/list_concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_concepts.js","sourceRoot":"","sources":["../../src/schemas/list_concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,wEAAwE;AACxE,2EAA2E;AAC3E,sEAAsE;AACtE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;KACxB,CAAC,CACH;CACF,CAAC,CAAC"}

package/dist/schemas/list_tables.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export declare const listTablesInputSchema: z.ZodObject<{
+    schema: z.ZodOptional<z.ZodString>;
+    includeSystem: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const listTablesOutputSchema: z.ZodObject<{
+    tables: z.ZodArray<z.ZodObject<{
+        qualifiedName: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        rowCountEstimate: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ListTablesInput = z.infer<typeof listTablesInputSchema>;
+export type ListTablesOutput = z.infer<typeof listTablesOutputSchema>;
+//# sourceMappingURL=list_tables.d.ts.map

package/dist/schemas/list_tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_tables.d.ts","sourceRoot":"","sources":["../../src/schemas/list_tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;iBASjC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schemas/list_tables.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const listTablesInputSchema = z.object({
+    schema: z.string().optional(),
+    includeSystem: z.boolean().optional(),
+});
+export const listTablesOutputSchema = z.object({
+    tables: z.array(z.object({
+        qualifiedName: z.string(),
+        label: z.string(),
+        description: z.string().nullable(),
+        rowCountEstimate: z.number().nullable(),
+    })),
+});
+//# sourceMappingURL=list_tables.js.map

package/dist/schemas/list_tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_tables.js","sourceRoot":"","sources":["../../src/schemas/list_tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;QACP,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACxC,CAAC,CACH;CACF,CAAC,CAAC"}

package/dist/schemas/list_views.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const listViewsInputSchema: z.ZodObject<{
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const listViewsOutputSchema: z.ZodObject<{
+    views: z.ZodArray<z.ZodObject<{
+        qualifiedName: z.ZodString;
+        label: z.ZodString;
+        purpose: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ListViewsInput = z.infer<typeof listViewsInputSchema>;
+export type ListViewsOutput = z.infer<typeof listViewsOutputSchema>;
+//# sourceMappingURL=list_views.d.ts.map

package/dist/schemas/list_views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_views.d.ts","sourceRoot":"","sources":["../../src/schemas/list_views.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAQhC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas/list_views.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export const listViewsInputSchema = z.object({
+    schema: z.string().optional(),
+});
+export const listViewsOutputSchema = z.object({
+    views: z.array(z.object({
+        qualifiedName: z.string(),
+        label: z.string(),
+        purpose: z.string().nullable(),
+    })),
+});
+//# sourceMappingURL=list_views.js.map

package/dist/schemas/list_views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_views.js","sourceRoot":"","sources":["../../src/schemas/list_views.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;QACP,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC,CACH;CACF,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SchemaCache } from './schemaCache.js';
+export declare function createMcpServer(cache: SchemaCache): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAWnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA+EpD,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAwC1D"}

package/dist/server.js

@@ -0,0 +1,114 @@
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { listTables } from './tools/list_tables.js';
+import { describeTable } from './tools/describe_table.js';
+import { listViews } from './tools/list_views.js';
+import { describeView } from './tools/describe_view.js';
+import { listConcepts } from './tools/list_concepts.js';
+import { getConceptContext } from './tools/get_concept_context.js';
+// Read the advertised server version from this package's package.json so
+// it tracks a release bump automatically instead of being hardcoded.
+// `../package.json` resolves to packages/mcp/package.json from the
+// compiled dist/server.js; npm always ships package.json in the tarball.
+const require = createRequire(import.meta.url);
+const pkg = JSON.parse(readFileSync(require.resolve('../package.json'), 'utf8'));
+const SERVER_VERSION = pkg.version;
+const TOOL_DEFINITIONS = [
+    {
+        name: 'list_tables',
+        description: 'List tables with their labels and descriptions',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                schema: { type: 'string', description: 'Target schema (default: public)' },
+                includeSystem: { type: 'boolean', description: 'Include system schemas (ignored in v0.1)' },
+            },
+        },
+    },
+    {
+        name: 'describe_table',
+        description: 'Return the full schema + COMMENT for the given table',
+        inputSchema: {
+            type: 'object',
+            properties: { qualifiedName: { type: 'string', description: 'e.g. public.users' } },
+            required: ['qualifiedName'],
+        },
+    },
+    {
+        name: 'list_views',
+        description: 'List views with their labels and purposes',
+        inputSchema: {
+            type: 'object',
+            properties: { schema: { type: 'string', description: 'Target schema (default: public)' } },
+        },
+    },
+    {
+        name: 'describe_view',
+        description: 'Return columns + purpose + underlying tables + definition for the given view',
+        inputSchema: {
+            type: 'object',
+            properties: { qualifiedName: { type: 'string', description: 'e.g. public.vw_active_users' } },
+            required: ['qualifiedName'],
+        },
+    },
+    {
+        name: 'list_concepts',
+        description: 'List domain concepts (each backed by a VIEW)',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'get_concept_context',
+        description: 'Return related tables + recommended query path for the given concept',
+        inputSchema: {
+            type: 'object',
+            properties: { name: { type: 'string', description: 'Matches the VIEW name' } },
+            required: ['name'],
+        },
+    },
+];
+function successResult(payload) {
+    return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+}
+function errorResult(message) {
+    return {
+        isError: true,
+        content: [{ type: 'text', text: message }],
+    };
+}
+export function createMcpServer(cache) {
+    const server = new Server({ name: 'kozou', version: SERVER_VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, () => Promise.resolve({ tools: TOOL_DEFINITIONS.map((t) => ({ ...t })) }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const name = request.params.name;
+        const args = (request.params.arguments ?? {});
+        try {
+            const ctx = await cache.get();
+            switch (name) {
+                case 'list_tables':
+                    return successResult(listTables(args, ctx));
+                case 'describe_table':
+                    return successResult(describeTable(args, ctx));
+                case 'list_views':
+                    return successResult(listViews(args, ctx));
+                case 'describe_view':
+                    return successResult(describeView(args, ctx));
+                case 'list_concepts':
+                    return successResult(listConcepts(args, ctx));
+                case 'get_concept_context':
+                    return successResult(getConceptContext(args, ctx));
+                default:
+                    return errorResult(`Unknown tool: ${name}`);
+            }
+        }
+        catch (err) {
+            const dev = process.env.KOZOU_DEV === '1';
+            const msg = err instanceof Error ? err.message : String(err);
+            const detail = dev && err instanceof Error && err.stack ? `\n${err.stack}` : '';
+            return errorResult(`${msg}${detail}`);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/startHttpServer.d.ts

@@ -0,0 +1,30 @@
+import type { SchemaCache } from './schemaCache.js';
+export type StartHttpServerOptions = {
+    /** TCP port to listen on. Default: 3334 (Kozou v0.1 spec §7.1). */
+    port?: number;
+    /** Host/interface to bind. Default: 127.0.0.1 (loopback only). */
+    host?: string;
+    /** Path that serves the MCP Streamable HTTP endpoint. Default: '/mcp'. */
+    mcpPath?: string;
+    /** Prefix used in stderr log lines. Default: '[@kozou/mcp]'. */
+    logPrefix?: string;
+};
+export type HttpServerHandle = {
+    /** The actual bound port (resolves an ephemeral `0` to the real port). */
+    port: number;
+    /** The host the server is bound to. */
+    host: string;
+    /** Stop accepting connections and resolve once the server has closed. */
+    close: () => Promise<void>;
+};
+export declare function isLoopbackHost(host: string): boolean;
+/**
+ * Start the MCP server over Streamable HTTP, bound to the given
+ * SchemaCache. Resolves once the server is listening.
+ *
+ * Routes:
+ *   - `<mcpPath>` (default `/mcp`)  — MCP Streamable HTTP endpoint
+ *   - `POST /admin/refresh`         — invalidate the schema cache
+ */
+export declare function startHttpServer(cache: SchemaCache, opts?: StartHttpServerOptions): Promise<HttpServerHandle>;
+//# sourceMappingURL=startHttpServer.d.ts.map

package/dist/startHttpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startHttpServer.d.ts","sourceRoot":"","sources":["../src/startHttpServer.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,sBAAsB,GAAG;IACnC,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AASF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAYD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,gBAAgB,CAAC,CA6C3B"}

package/dist/startHttpServer.js

@@ -0,0 +1,176 @@
+// Convenience helper to start an MCP server with the Streamable HTTP
+// transport (Kozou v0.1 spec §7.1). Mirrors startStdioServer so callers
+// (the bundled kozou CLI and adopters embedding the server) do not need
+// to depend on @modelcontextprotocol/sdk or node:http directly.
+//
+// Design notes:
+//   - The server is *stateful*: an MCP client initialises a session, the
+//     transport issues an `mcp-session-id`, and subsequent requests reuse
+//     the matching transport. This is the transport mode the standard MCP
+//     client (Claude Desktop / Claude Code) speaks. Sessions are torn
+//     down on transport close so nothing accumulates.
+//   - Cache invalidation is exposed over HTTP via `POST /admin/refresh`
+//     (Kozou v0.1 spec §7.5), the HTTP-mode counterpart to the stdio
+//     server's SIGHUP handler.
+//   - v0.1 MCP HTTP ships with **no authentication** (spec §18.5), so the
+//     server binds to localhost by default and prints a loud warning when
+//     bound to a non-loopback host. The tools only expose schema
+//     metadata (no SQL execution, no data access), which bounds the blast
+//     radius, but operators must still avoid exposing it on a public
+//     interface.
+import { randomUUID } from 'node:crypto';
+import { createServer } from 'node:http';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { createMcpServer } from './server.js';
+const DEFAULT_PORT = 3334;
+const DEFAULT_HOST = '127.0.0.1';
+const DEFAULT_MCP_PATH = '/mcp';
+const REFRESH_PATH = '/admin/refresh';
+const LOOPBACK_HOSTS = new Set(['127.0.0.1', '::1', 'localhost', '::ffff:127.0.0.1']);
+export function isLoopbackHost(host) {
+    return LOOPBACK_HOSTS.has(host);
+}
+function nonLoopbackWarning(host, prefix) {
+    return (`${prefix} WARNING: MCP HTTP server bound to non-loopback host "${host}".\n` +
+        `${prefix} v0.1 MCP HTTP has NO authentication (spec §18.5). Anyone who can\n` +
+        `${prefix} reach ${host} can read this database's schema metadata. Bind to\n` +
+        `${prefix} 127.0.0.1 (the default) unless you have a trusted network and an\n` +
+        `${prefix} external auth/proxy layer in front.\n`);
+}
+/**
+ * Start the MCP server over Streamable HTTP, bound to the given
+ * SchemaCache. Resolves once the server is listening.
+ *
+ * Routes:
+ *   - `<mcpPath>` (default `/mcp`)  — MCP Streamable HTTP endpoint
+ *   - `POST /admin/refresh`         — invalidate the schema cache
+ */
+export async function startHttpServer(cache, opts = {}) {
+    const prefix = opts.logPrefix ?? '[@kozou/mcp]';
+    const host = opts.host ?? DEFAULT_HOST;
+    const port = opts.port ?? DEFAULT_PORT;
+    const mcpPath = opts.mcpPath ?? DEFAULT_MCP_PATH;
+    if (!isLoopbackHost(host)) {
+        process.stderr.write(nonLoopbackWarning(host, prefix));
+    }
+    // Active MCP sessions, keyed by the transport-issued session id.
+    const transports = new Map();
+    const httpServer = createServer((req, res) => {
+        handleRequest(req, res, cache, mcpPath, transports).catch((err) => {
+            respondError(res, 500, err instanceof Error ? err.message : String(err));
+        });
+    });
+    await new Promise((resolve, reject) => {
+        const onError = (err) => reject(err);
+        httpServer.once('error', onError);
+        httpServer.listen(port, host, () => {
+            httpServer.removeListener('error', onError);
+            resolve();
+        });
+    });
+    const boundPort = httpServer.address().port;
+    process.stderr.write(`${prefix} MCP HTTP listening on http://${host}:${boundPort}` +
+        ` (MCP: ${mcpPath}, refresh: POST ${REFRESH_PATH})\n`);
+    return {
+        port: boundPort,
+        host,
+        close: async () => {
+            for (const transport of transports.values()) {
+                await transport.close();
+            }
+            transports.clear();
+            await closeServer(httpServer);
+        },
+    };
+}
+async function handleRequest(req, res, cache, mcpPath, transports) {
+    const url = new URL(req.url ?? '/', 'http://localhost');
+    if (url.pathname === REFRESH_PATH) {
+        if (req.method !== 'POST') {
+            respondError(res, 405, 'Method Not Allowed: use POST /admin/refresh');
+            return;
+        }
+        cache.invalidate();
+        res.writeHead(200, { 'content-type': 'application/json' });
+        res.end(JSON.stringify({ ok: true }));
+        return;
+    }
+    if (url.pathname === mcpPath) {
+        await handleMcp(req, res, cache, transports);
+        return;
+    }
+    respondError(res, 404, `Not Found: ${url.pathname}`);
+}
+async function handleMcp(req, res, cache, transports) {
+    const sessionId = headerValue(req.headers['mcp-session-id']);
+    // Existing session: reuse its transport (and the MCP server bound to it).
+    if (sessionId !== undefined) {
+        const existing = transports.get(sessionId);
+        if (existing === undefined) {
+            respondError(res, 404, `Unknown MCP session: ${sessionId}`);
+            return;
+        }
+        await existing.handleRequest(req, res);
+        return;
+    }
+    // No session id: this must be an initialize request that opens a new
+    // session. The body is read once here so we can both classify it and
+    // hand it to the transport (which would otherwise consume the stream).
+    const body = await readJsonBody(req);
+    if (!isInitializeRequest(body)) {
+        respondError(res, 400, 'Bad Request: missing mcp-session-id header (no active session)');
+        return;
+    }
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+        enableJsonResponse: true,
+        onsessioninitialized: (sid) => {
+            transports.set(sid, transport);
+        },
+    });
+    transport.onclose = () => {
+        if (transport.sessionId !== undefined) {
+            transports.delete(transport.sessionId);
+        }
+    };
+    const server = createMcpServer(cache);
+    await server.connect(transport);
+    await transport.handleRequest(req, res, body);
+}
+function headerValue(value) {
+    if (Array.isArray(value))
+        return value[0];
+    return value;
+}
+async function readJsonBody(req) {
+    const chunks = [];
+    for await (const chunk of req) {
+        chunks.push(chunk);
+    }
+    if (chunks.length === 0)
+        return undefined;
+    const raw = Buffer.concat(chunks).toString('utf8');
+    if (raw.length === 0)
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+function respondError(res, status, message) {
+    if (res.headersSent) {
+        res.end();
+        return;
+    }
+    res.writeHead(status, { 'content-type': 'application/json' });
+    res.end(JSON.stringify({ error: message }));
+}
+function closeServer(httpServer) {
+    return new Promise((resolve, reject) => {
+        httpServer.close((err) => (err ? reject(err) : resolve()));
+    });
+}
+//# sourceMappingURL=startHttpServer.js.map

package/dist/startHttpServer.js.map

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

package/dist/startStdioServer.d.ts

@@ -0,0 +1,14 @@
+import type { SchemaCache } from './schemaCache.js';
+export type StartStdioServerOptions = {
+    /** Prefix used in stderr log lines. Default: '[@kozou/mcp]'. */
+    logPrefix?: string;
+};
+/**
+ * Start the MCP server bound to the given SchemaCache, using a stdio
+ * transport. Installs a SIGHUP handler that invalidates the cache, so
+ * adopters can refresh the schema without restarting the process.
+ *
+ * Resolves once the underlying transport finishes connecting.
+ */
+export declare function startStdioServer(cache: SchemaCache, opts?: StartStdioServerOptions): Promise<void>;
+//# sourceMappingURL=startStdioServer.d.ts.map

package/dist/startStdioServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startStdioServer.d.ts","sourceRoot":"","sources":["../src/startStdioServer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,uBAAuB,GAAG;IACpC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/startStdioServer.js

@@ -0,0 +1,25 @@
+// Convenience helper to start an MCP server with the stdio transport.
+//
+// This lives in @kozou/mcp so callers (the bundled kozou CLI as well as
+// adopters embedding the MCP server in their own scripts) do not need to
+// depend on @modelcontextprotocol/sdk directly.
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createMcpServer } from './server.js';
+/**
+ * Start the MCP server bound to the given SchemaCache, using a stdio
+ * transport. Installs a SIGHUP handler that invalidates the cache, so
+ * adopters can refresh the schema without restarting the process.
+ *
+ * Resolves once the underlying transport finishes connecting.
+ */
+export async function startStdioServer(cache, opts = {}) {
+    const prefix = opts.logPrefix ?? '[@kozou/mcp]';
+    const server = createMcpServer(cache);
+    process.on('SIGHUP', () => {
+        cache.invalidate();
+        process.stderr.write(`${prefix} SIGHUP received, cache invalidated\n`);
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=startStdioServer.js.map

package/dist/startStdioServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startStdioServer.js","sourceRoot":"","sources":["../src/startStdioServer.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,gDAAgD;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQ9C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAkB,EAClB,OAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,cAAc,CAAC;IAChD,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,KAAK,CAAC,UAAU,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,uCAAuC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/describe_table.d.ts

@@ -0,0 +1,4 @@
+import type { SchemaContext } from '@kozou/core';
+import { type DescribeTableInput, type DescribeTableOutput } from '../schemas/describe_table.js';
+export declare function describeTable(input: DescribeTableInput, ctx: SchemaContext): DescribeTableOutput;
+//# sourceMappingURL=describe_table.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe_table.d.ts","sourceRoot":"","sources":["../../src/tools/describe_table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAEzB,MAAM,8BAA8B,CAAC;AAEtC,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,EAAE,aAAa,GAAG,mBAAmB,CA6ChG"}

package/dist/tools/describe_table.js

@@ -0,0 +1,45 @@
+import { describeTableInputSchema, } from '../schemas/describe_table.js';
+export function describeTable(input, ctx) {
+    const parsed = describeTableInputSchema.parse(input);
+    const table = ctx.tables.find((t) => t.qualifiedName === parsed.qualifiedName);
+    if (!table) {
+        throw new Error(`Table not found: ${parsed.qualifiedName}`);
+    }
+    const referencesByField = new Map();
+    for (const rel of table.relations) {
+        referencesByField.set(rel.field, {
+            table: `${rel.references.schema}.${rel.references.table}`,
+            column: rel.references.column,
+        });
+    }
+    const columns = table.columns.map((c) => ({
+        name: c.name,
+        dataType: c.dataType,
+        nullable: c.nullable,
+        defaultExpr: c.defaultExpr,
+        description: c.description,
+        aiDescription: c.aiDescription,
+        enumValues: c.enumValues,
+        isForeignKey: c.isForeignKey,
+        references: referencesByField.get(c.name) ?? null,
+    }));
+    return {
+        qualifiedName: table.qualifiedName,
+        label: table.label,
+        description: table.description,
+        aiDescription: table.aiDescription,
+        primaryKey: table.primaryKey,
+        columns,
+        relations: table.relations.map((r) => ({
+            field: r.field,
+            referencesTable: `${r.references.schema}.${r.references.table}`,
+            referencesColumn: r.references.column,
+            meaning: r.meaning,
+        })),
+        checkConstraints: table.rawTable.checks.map((c) => ({
+            name: c.name,
+            expression: c.expression,
+        })),
+    };
+}
+//# sourceMappingURL=describe_table.js.map

package/dist/tools/describe_table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe_table.js","sourceRoot":"","sources":["../../src/tools/describe_table.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,GAIzB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,UAAU,aAAa,CAAC,KAAyB,EAAE,GAAkB;IACzE,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa,CAAC,CAAC;IAC/E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA6C,CAAC;IAC/E,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAClC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE;YAC/B,KAAK,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE;YACzD,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,MAAM;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAA0B,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,UAAU,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI;KAClD,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO;QACP,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,eAAe,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE;YAC/D,gBAAgB,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM;YACrC,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC;QACH,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/tools/describe_view.d.ts

@@ -0,0 +1,4 @@
+import type { SchemaContext } from '@kozou/core';
+import { type DescribeViewInput, type DescribeViewOutput } from '../schemas/describe_view.js';
+export declare function describeView(input: DescribeViewInput, ctx: SchemaContext): DescribeViewOutput;
+//# sourceMappingURL=describe_view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe_view.d.ts","sourceRoot":"","sources":["../../src/tools/describe_view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AAErC,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,aAAa,GAAG,kBAAkB,CAyB7F"}

package/dist/tools/describe_view.js

@@ -0,0 +1,28 @@
+import { describeViewInputSchema, } from '../schemas/describe_view.js';
+export function describeView(input, ctx) {
+    const parsed = describeViewInputSchema.parse(input);
+    const view = ctx.views.find((v) => v.qualifiedName === parsed.qualifiedName);
+    if (!view) {
+        throw new Error(`View not found: ${parsed.qualifiedName}`);
+    }
+    return {
+        qualifiedName: view.qualifiedName,
+        label: view.label,
+        description: view.description,
+        aiDescription: view.aiDescription,
+        columns: view.columns.map((c) => ({
+            name: c.name,
+            dataType: c.dataType,
+            nullable: c.nullable,
+            defaultExpr: c.defaultExpr,
+            description: c.description,
+            aiDescription: c.aiDescription,
+            enumValues: c.enumValues,
+            isForeignKey: c.isForeignKey,
+            references: null,
+        })),
+        underlyingTables: view.underlyingTables.map((t) => `${t.schema}.${t.name}`),
+        definition: view.rawView.definition,
+    };
+}
+//# sourceMappingURL=describe_view.js.map

package/dist/tools/describe_view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe_view.js","sourceRoot":"","sources":["../../src/tools/describe_view.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,GAGxB,MAAM,6BAA6B,CAAC;AAErC,MAAM,UAAU,YAAY,CAAC,KAAwB,EAAE,GAAkB;IACvE,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QACH,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3E,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;KACpC,CAAC;AACJ,CAAC"}

package/dist/tools/get_concept_context.d.ts

@@ -0,0 +1,4 @@
+import type { SchemaContext } from '@kozou/core';
+import { type GetConceptContextInput, type GetConceptContextOutput } from '../schemas/get_concept_context.js';
+export declare function getConceptContext(input: GetConceptContextInput, ctx: SchemaContext): GetConceptContextOutput;
+//# sourceMappingURL=get_concept_context.d.ts.map