@zmdb/mcp 1.0.0-beta.1

package/README.md

@@ -0,0 +1,70 @@
+# @zmdb/mcp
+
+`@zmdb/mcp` provides transport-neutral MCP client and server cores. It validates every protocol envelope, routes only registered tools, resolves caller identity through an application-supplied
+function, and bounds remote call count and response bytes.
+
+The package does not open sockets, read process streams, mount an HTTP framework, or depend on an MCP SDK. Applications own stdio or HTTP framing and authentication.
+
+## Install
+
+```bash
+yarn add @zmdb/ai@1.0.0-beta.1 @zmdb/mcp@1.0.0-beta.1
+```
+
+> **Prerelease** (`1.0.0-beta.1`). Requires **Node.js 26+** and is **ESM-only**. The runtime uses platform APIs and caller-supplied transports.
+
+## Server
+
+```ts
+import { defineTools } from '@zmdb/ai/chat';
+import { createMcpServer } from '@zmdb/mcp';
+
+const tools = defineTools({
+  lookup: {
+    spec: {
+      name: 'lookup',
+      parameters: { type: 'object', properties: {}, required: [] },
+    },
+    validate: value => value,
+    handler: (input, identity) => JSON.stringify({ input, identity }),
+    effectful: false,
+  },
+});
+
+const server = createMcpServer(tools, {
+  serverInfo: { name: 'catalog', version: '1.0.0' },
+  identify: transport => authenticateTransport(transport),
+});
+
+const answer = await server.handle(message, transport);
+```
+
+`identify` is mandatory. The application decides how a stdio process or HTTP request becomes an authenticated identity before a tool runs.
+
+## Client
+
+```ts
+import { createMcpClient } from '@zmdb/mcp';
+
+const client = createMcpClient(sendJsonRpc, {
+  maxCalls: 32,
+  maxResponseBytes: 256 * 1024,
+});
+
+const tools = await client.listTools();
+const result = await client.callTool('lookup', { id: 'item-7' });
+```
+
+`sendJsonRpc` supplies the transport. Remote schemas, arguments, and result text remain untrusted data; validate application payloads at your own boundary.
+
+## Entry point
+
+- `@zmdb/mcp` — `MCP_PROTOCOL_VERSION`, `createMcpServer`, `createMcpClient`, `McpProtocolError`, and their public contracts.
+
+## Documentation
+
+Full project documentation is at **https://ambasta.github.io/zmdb/**.
+
+## License
+
+GNU General Public License v3.0 or later (GPL-3.0-or-later).

package/dist/client.d.ts

@@ -0,0 +1,32 @@
+export interface RemoteTool {
+    readonly name: string;
+    readonly description?: string;
+    readonly inputSchema: Readonly<Record<string, unknown>>;
+}
+export interface RemoteToolResult {
+    readonly content: readonly {
+        readonly type: string;
+        readonly text?: string;
+    }[];
+    readonly isError: boolean;
+}
+export interface McpClient {
+    listTools(): Promise<readonly RemoteTool[]>;
+    callTool(name: string, args: unknown): Promise<RemoteToolResult>;
+}
+export interface McpClientOptions {
+    readonly maxCalls?: number;
+    readonly maxResponseBytes?: number;
+    readonly clientInfo?: {
+        readonly name: string;
+        readonly version: string;
+    };
+    readonly clientCapabilities?: Readonly<Record<string, unknown>>;
+}
+export declare class McpProtocolError extends Error {
+    readonly code: number;
+    readonly data: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+export declare function createMcpClient(send: (message: unknown) => Promise<unknown>, opts?: McpClientOptions): McpClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjE;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAKxD;CACF;AAiFD,wBAAgB,eAAe,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,GAAE,gBAAqB,GAAG,SAAS,CAwDpH"}

package/dist/client.js

@@ -0,0 +1,141 @@
+// Transport-neutral MCP client owned by @zmdb/mcp.
+import { MCP_PROTOCOL_VERSION } from './server.js';
+const PROTOCOL_VERSION_KEY = 'io.modelcontextprotocol/protocolVersion';
+const CLIENT_INFO_KEY = 'io.modelcontextprotocol/clientInfo';
+const CLIENT_CAPABILITIES_KEY = 'io.modelcontextprotocol/clientCapabilities';
+const DEFAULT_MAX_CALLS = 64;
+const DEFAULT_MAX_RESPONSE_BYTES = 1024 * 1024;
+export class McpProtocolError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.name = 'McpProtocolError';
+        this.code = code;
+        this.data = data;
+    }
+}
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const field = (value, key) => Reflect.get(value, key);
+const positiveSafeInteger = (value, name) => {
+    if (!Number.isSafeInteger(value) || value <= 0)
+        throw new RangeError(`${name} must be a positive safe integer`);
+    return value;
+};
+const boundedResponse = (value, maxResponseBytes) => {
+    const serialised = typeof value === 'string' ? value : JSON.stringify(value);
+    if (serialised === undefined)
+        throw new TypeError('MCP transport returned a non-JSON value');
+    if (new TextEncoder().encode(serialised).byteLength > maxResponseBytes) {
+        throw new RangeError(`MCP response exceeds maxResponseBytes (${String(maxResponseBytes)})`);
+    }
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        throw new TypeError('MCP transport returned invalid JSON');
+    }
+};
+const responseResult = (response, id, maxResponseBytes) => {
+    const bounded = boundedResponse(response, maxResponseBytes);
+    if (!isRecord(bounded) || field(bounded, 'jsonrpc') !== '2.0' || field(bounded, 'id') !== id) {
+        throw new TypeError('invalid MCP response envelope');
+    }
+    const rawError = field(bounded, 'error');
+    if (rawError !== undefined) {
+        if (!isRecord(rawError))
+            throw new TypeError('invalid MCP error response');
+        const code = field(rawError, 'code');
+        const message = field(rawError, 'message');
+        if (typeof code !== 'number' || !Number.isInteger(code) || typeof message !== 'string') {
+            throw new TypeError('invalid MCP error response');
+        }
+        throw new McpProtocolError(code, message, field(rawError, 'data'));
+    }
+    const result = field(bounded, 'result');
+    if (!isRecord(result))
+        throw new TypeError('invalid MCP result response');
+    const resultType = field(result, 'resultType');
+    if (resultType !== undefined && resultType !== 'complete') {
+        throw new TypeError(`unsupported MCP resultType ${String(resultType)}`);
+    }
+    return result;
+};
+const remoteToolOf = (value) => {
+    if (!isRecord(value))
+        throw new TypeError('invalid remote MCP tool');
+    const name = field(value, 'name');
+    const description = field(value, 'description');
+    const inputSchema = field(value, 'inputSchema');
+    if (typeof name !== 'string' ||
+        (description !== undefined && typeof description !== 'string') ||
+        !isRecord(inputSchema)) {
+        throw new TypeError('invalid remote MCP tool');
+    }
+    return description === undefined ? { name, inputSchema } : { name, description, inputSchema };
+};
+const contentBlockOf = (value) => {
+    if (!isRecord(value))
+        throw new TypeError('invalid remote MCP content block');
+    const type = field(value, 'type');
+    const text = field(value, 'text');
+    if (typeof type !== 'string' || (text !== undefined && typeof text !== 'string')) {
+        throw new TypeError('invalid remote MCP content block');
+    }
+    return text === undefined ? { ...value, type } : { ...value, type, text };
+};
+export function createMcpClient(send, opts = {}) {
+    const maxCalls = positiveSafeInteger(opts.maxCalls ?? DEFAULT_MAX_CALLS, 'maxCalls');
+    const maxResponseBytes = positiveSafeInteger(opts.maxResponseBytes ?? DEFAULT_MAX_RESPONSE_BYTES, 'maxResponseBytes');
+    const clientCapabilities = opts.clientCapabilities ?? {};
+    let nextId = 1;
+    let calls = 0;
+    const request = async (method, params) => {
+        if (calls >= maxCalls)
+            throw new RangeError(`MCP client call budget exhausted (${String(maxCalls)})`);
+        calls += 1;
+        const id = nextId;
+        nextId += 1;
+        const meta = opts.clientInfo === undefined
+            ? {
+                [PROTOCOL_VERSION_KEY]: MCP_PROTOCOL_VERSION,
+                [CLIENT_CAPABILITIES_KEY]: clientCapabilities,
+            }
+            : {
+                [PROTOCOL_VERSION_KEY]: MCP_PROTOCOL_VERSION,
+                [CLIENT_INFO_KEY]: opts.clientInfo,
+                [CLIENT_CAPABILITIES_KEY]: clientCapabilities,
+            };
+        const response = await send({
+            jsonrpc: '2.0',
+            id,
+            method,
+            params: { ...params, _meta: meta },
+        });
+        return responseResult(response, id, maxResponseBytes);
+    };
+    return {
+        async listTools() {
+            const result = await request('tools/list', {});
+            const tools = field(result, 'tools');
+            if (!Array.isArray(tools))
+                throw new TypeError('invalid MCP tools/list result');
+            return tools.map(remoteToolOf);
+        },
+        async callTool(name, args) {
+            const result = await request('tools/call', { name, arguments: args });
+            const content = field(result, 'content');
+            const isError = field(result, 'isError');
+            if (!Array.isArray(content) || (isError !== undefined && typeof isError !== 'boolean')) {
+                throw new TypeError('invalid MCP tools/call result');
+            }
+            return {
+                content: content.map(contentBlockOf),
+                isError: isError ?? false,
+            };
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { MCP_PROTOCOL_VERSION, createMcpServer, type McpServer, type McpServerOptions } from './server.js';
+export { McpProtocolError, createMcpClient, type McpClient, type McpClientOptions, type RemoteTool, type RemoteToolResult, } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// The complete public surface of @zmdb/mcp.
+export { MCP_PROTOCOL_VERSION, createMcpServer } from './server.js';
+export { McpProtocolError, createMcpClient, } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAyC,MAAM,aAAa,CAAC;AAC3G,OAAO,EACL,gBAAgB,EAChB,eAAe,GAKhB,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,28 @@
+export declare const MCP_PROTOCOL_VERSION = "2026-07-28";
+export interface McpServer {
+    handle(message: unknown, transport: unknown): Promise<unknown | undefined>;
+}
+export interface McpServerOptions {
+    readonly serverInfo: {
+        readonly name: string;
+        readonly version: string;
+    };
+    readonly identify: (transport: unknown) => Promise<unknown>;
+}
+type McpToolHandler = {
+    bivarianceHack(input: unknown, identity?: unknown): unknown | PromiseLike<unknown>;
+}['bivarianceHack'];
+interface McpToolEntry {
+    readonly spec: {
+        readonly name: string;
+        readonly description?: string;
+        readonly parameters: unknown;
+    };
+    readonly validate: (args: unknown) => unknown;
+    readonly handler: McpToolHandler;
+    readonly effectful?: boolean;
+}
+type McpToolRegistry = Readonly<Record<string, McpToolEntry>>;
+export declare function createMcpServer(tools: McpToolRegistry, opts: McpServerOptions): McpServer;
+export {};
+//# 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,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAqCjD,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED,KAAK,cAAc,GAAG;IACpB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;CACpF,CAAC,gBAAgB,CAAC,CAAC;AAEpB,UAAU,YAAY;IACpB,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;KAC9B,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,KAAK,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;AA8G9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAAC"}

package/dist/server.js

@@ -0,0 +1,153 @@
+import { invokeTool } from '@zmdb/ai/tool-runtime';
+export const MCP_PROTOCOL_VERSION = '2026-07-28';
+const PARSE_ERROR = -32_700;
+const INVALID_REQUEST = -32_600;
+const METHOD_NOT_FOUND = -32_601;
+const INVALID_PARAMS = -32_602;
+const UNSUPPORTED_PROTOCOL_VERSION = -32_022;
+const PROTOCOL_VERSION_KEY = 'io.modelcontextprotocol/protocolVersion';
+const CLIENT_CAPABILITIES_KEY = 'io.modelcontextprotocol/clientCapabilities';
+const SERVER_INFO_KEY = 'io.modelcontextprotocol/serverInfo';
+const toolErrorId = () => [...globalThis.crypto.getRandomValues(new Uint8Array(4))].map(byte => byte.toString(16).padStart(2, '0')).join('');
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const field = (value, key) => Reflect.get(value, key);
+const requestIdOf = (value) => {
+    if (typeof value === 'string')
+        return value;
+    return typeof value === 'number' && Number.isSafeInteger(value) ? value : null;
+};
+const parseMessage = (message) => {
+    let value = message;
+    if (typeof message === 'string') {
+        try {
+            value = JSON.parse(message);
+        }
+        catch {
+            return { kind: 'invalid', id: null, code: PARSE_ERROR, message: 'Parse error' };
+        }
+    }
+    if (!isRecord(value)) {
+        return { kind: 'invalid', id: null, code: INVALID_REQUEST, message: 'Invalid Request' };
+    }
+    const rawId = field(value, 'id');
+    const id = requestIdOf(rawId);
+    if (field(value, 'jsonrpc') !== '2.0' || typeof field(value, 'method') !== 'string') {
+        return { kind: 'invalid', id, code: INVALID_REQUEST, message: 'Invalid Request' };
+    }
+    if (!Object.hasOwn(value, 'id'))
+        return { kind: 'notification' };
+    if (id === null)
+        return { kind: 'invalid', id: null, code: INVALID_REQUEST, message: 'Invalid Request' };
+    const method = field(value, 'method');
+    const rawParams = field(value, 'params');
+    if (rawParams !== undefined && !isRecord(rawParams)) {
+        return { kind: 'invalid', id, code: INVALID_PARAMS, message: 'Invalid params' };
+    }
+    return {
+        kind: 'request',
+        id,
+        method: typeof method === 'string' ? method : '',
+        params: rawParams ?? {},
+    };
+};
+const errorResponse = (id, code, message, data) => ({
+    jsonrpc: '2.0',
+    id,
+    error: data === undefined ? { code, message } : { code, message, data },
+});
+const responseMeta = (serverInfo) => ({
+    [SERVER_INFO_KEY]: serverInfo,
+});
+const resultResponse = (id, serverInfo, result) => ({
+    jsonrpc: '2.0',
+    id,
+    result: {
+        ...result,
+        resultType: 'complete',
+        _meta: responseMeta(serverInfo),
+    },
+});
+const protocolVersionOf = (params) => {
+    const meta = field(params, '_meta');
+    if (!isRecord(meta))
+        return undefined;
+    const version = field(meta, PROTOCOL_VERSION_KEY);
+    const capabilities = field(meta, CLIENT_CAPABILITIES_KEY);
+    return typeof version === 'string' && isRecord(capabilities) ? version : undefined;
+};
+const toolCallOf = (params) => {
+    const name = field(params, 'name');
+    if (typeof name !== 'string')
+        return undefined;
+    return { name, args: field(params, 'arguments') ?? {} };
+};
+const contentResult = (id, serverInfo, text, isError) => resultResponse(id, serverInfo, {
+    content: [{ type: 'text', text }],
+    isError,
+});
+export function createMcpServer(tools, opts) {
+    const entries = Object.entries(tools);
+    for (const [key, entry] of entries) {
+        if (entry.spec.name !== key) {
+            throw new Error(`tool registry key ${key} does not match spec name ${entry.spec.name}`);
+        }
+    }
+    const entriesByName = new Map(entries);
+    return {
+        async handle(message, transport) {
+            const identity = await opts.identify(transport);
+            const parsed = parseMessage(message);
+            if (parsed.kind === 'notification')
+                return undefined;
+            if (parsed.kind === 'invalid') {
+                return errorResponse(parsed.id, parsed.code, parsed.message);
+            }
+            const protocolVersion = protocolVersionOf(parsed.params);
+            if (protocolVersion === undefined) {
+                return errorResponse(parsed.id, INVALID_PARAMS, 'Missing required MCP request metadata');
+            }
+            if (protocolVersion !== MCP_PROTOCOL_VERSION) {
+                return errorResponse(parsed.id, UNSUPPORTED_PROTOCOL_VERSION, 'Unsupported protocol version', {
+                    supported: [MCP_PROTOCOL_VERSION],
+                    requested: protocolVersion,
+                });
+            }
+            if (parsed.method === 'server/discover') {
+                return resultResponse(parsed.id, opts.serverInfo, {
+                    supportedVersions: [MCP_PROTOCOL_VERSION],
+                    capabilities: { tools: {} },
+                });
+            }
+            if (parsed.method === 'tools/list') {
+                return resultResponse(parsed.id, opts.serverInfo, {
+                    tools: entries.map(([, entry]) => entry.spec.description === undefined
+                        ? { name: entry.spec.name, inputSchema: entry.spec.parameters }
+                        : {
+                            name: entry.spec.name,
+                            description: entry.spec.description,
+                            inputSchema: entry.spec.parameters,
+                        }),
+                });
+            }
+            if (parsed.method !== 'tools/call') {
+                return errorResponse(parsed.id, METHOD_NOT_FOUND, 'Method not found');
+            }
+            const call = toolCallOf(parsed.params);
+            if (call === undefined)
+                return errorResponse(parsed.id, INVALID_PARAMS, 'Invalid tool call');
+            const entry = entriesByName.get(call.name);
+            if (entry === undefined)
+                return errorResponse(parsed.id, INVALID_PARAMS, `unknown tool ${call.name}`);
+            const invocation = await invokeTool(entry, call.args, identity);
+            if (invocation.kind === 'success') {
+                return contentResult(parsed.id, opts.serverInfo, invocation.content, false);
+            }
+            if (invocation.kind === 'validation-error' && invocation.content !== undefined) {
+                return contentResult(parsed.id, opts.serverInfo, invocation.content, true);
+            }
+            const id = toolErrorId();
+            return contentResult(parsed.id, opts.serverInfo, `tool ${call.name} failed (${id})`, true);
+        },
+    };
+}
+//# 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/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@zmdb/mcp",
+  "version": "1.0.0-beta.1",
+  "description": "Transport-neutral MCP client and server cores with validated tool dispatch, authenticated identity, and bounded remote calls.",
+  "keywords": [
+    "ai",
+    "json-rpc",
+    "llm",
+    "mcp",
+    "model-context-protocol",
+    "typescript",
+    "zmdb"
+  ],
+  "homepage": "https://github.com/ambasta/zmdb#readme",
+  "bugs": {
+    "url": "https://github.com/ambasta/zmdb/issues"
+  },
+  "license": "GPL-3.0-or-later",
+  "author": "zmdb contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ambasta/zmdb.git",
+    "directory": "packages/mcp"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@zmdb/ai": "1.0.0-beta.1"
+  },
+  "engines": {
+    "node": ">=26"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}