@contractspec/lib.contracts-runtime-server-mcp 2.0.0

package/dist/node/provider-mcp.js

@@ -0,0 +1,181 @@
+// src/mcp/registerTools.ts
+import { defaultMcpTool } from "@contractspec/lib.contracts-spec/jsonschema";
+function registerMcpTools(server, ops, ctx) {
+  for (const spec of ops.list()) {
+    if (spec.meta.kind !== "command")
+      continue;
+    const toolName = spec.transport?.mcp?.toolName ?? defaultMcpTool(spec.meta.key, spec.meta.version);
+    server.registerTool(toolName, {
+      description: spec.meta.description,
+      inputSchema: spec.io.input?.getZod()
+    }, async (args) => {
+      const result = await ops.execute(spec.meta.key, spec.meta.version, args ?? {}, ctx.toolCtx());
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 4) }]
+      };
+    });
+  }
+}
+
+// src/mcp/registerResources.ts
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Buffer } from "node:buffer";
+function mcpResourceMeta(resource) {
+  return {
+    title: resource.meta.title,
+    description: resource.meta.description,
+    mimeType: resource.meta.mimeType,
+    _meta: { tags: resource.meta.tags ?? [] }
+  };
+}
+function registerMcpResources(server, resources, ctx) {
+  for (const resource of resources.listTemplates()) {
+    ctx.logger.debug("Registering resource: " + resource.meta.uriTemplate);
+    server.registerResource(resource.meta.uriTemplate, new ResourceTemplate(resource.meta.uriTemplate, { list: undefined }), mcpResourceMeta(resource), async (_uri, variables) => {
+      const parsedArgs = resource.input.parse(variables);
+      const out = await resource.resolve(parsedArgs, ctx.resourceCtx());
+      if (typeof out.data === "string") {
+        return {
+          contents: [
+            {
+              uri: out.uri,
+              mimeType: out.mimeType ?? resource.meta.mimeType,
+              text: out.data
+            }
+          ]
+        };
+      }
+      return {
+        contents: [
+          {
+            uri: out.uri,
+            mimeType: out.mimeType ?? resource.meta.mimeType,
+            blob: Buffer.from(out.data).toString("base64")
+          }
+        ]
+      };
+    });
+    ctx.logger.debug("Registered resource: " + resource.meta.uriTemplate);
+  }
+}
+
+// src/mcp/registerPrompts.ts
+import { defaultMcpPrompt } from "@contractspec/lib.contracts-spec/jsonschema";
+function promptArgsSchemaFromPromptArgs(args) {
+  const shape = {};
+  for (const a of args)
+    shape[a.name] = a.schema;
+  return shape;
+}
+function registerMcpPrompts(server, prompts, ctx) {
+  for (const prompt of prompts.list()) {
+    const promptName = defaultMcpPrompt(prompt.meta.key);
+    server.registerPrompt(promptName, {
+      title: prompt.meta.title,
+      description: prompt.meta.description,
+      argsSchema: promptArgsSchemaFromPromptArgs(prompt.args)
+    }, async (args) => {
+      const link = (tpl, vars) => {
+        let out = tpl;
+        for (const [k, v] of Object.entries(vars)) {
+          out = out.replace(new RegExp(`\\{${k}\\}`, "g"), encodeURIComponent(String(v)));
+        }
+        return out;
+      };
+      const parts = await prompt.render(prompt.input.parse(args), {
+        ...ctx.promptCtx(),
+        link
+      });
+      const text = parts.map((p) => p.type === "text" ? p.text : `See resource: ${p.title ?? p.uri}
+URI: ${p.uri}`).join(`
+
+`);
+      const contents = {
+        type: "text",
+        text
+      };
+      return {
+        messages: [{ role: "assistant", content: contents }],
+        description: prompt.meta.description
+      };
+    });
+  }
+}
+
+// src/mcp/registerPresentations.ts
+import"@contractspec/lib.contracts-spec/presentations";
+import {
+  createDefaultTransformEngine,
+  registerBasicValidation,
+  registerDefaultReactRenderer
+} from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import { sanitizeMcpName } from "@contractspec/lib.contracts-spec/jsonschema";
+function isEngineRenderOutput(x) {
+  if (!x || typeof x !== "object")
+    return false;
+  return "body" in x && typeof x.body === "string";
+}
+function registerMcpPresentations(server, ctx) {
+  if (!ctx.presentations?.count()) {
+    return;
+  }
+  const engine = registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
+  for (const presentationSpec of ctx.presentations.list()) {
+    const baseKey = sanitizeMcpName(`presentation_${presentationSpec.meta.key}_v${presentationSpec.meta.version}`);
+    const baseUri = `presentation://${presentationSpec.meta.key}/v${presentationSpec.meta.version}`;
+    ctx.logger.debug(`Registering presentation ${baseUri} for ${baseKey}`);
+    server.registerResource(baseKey, baseUri, {
+      title: `${presentationSpec.meta.key} v${presentationSpec.meta.version}`,
+      description: presentationSpec.meta.description ?? "Presentation",
+      mimeType: "application/json"
+    }, async () => {
+      const jsonText = JSON.stringify({
+        meta: presentationSpec.meta,
+        source: presentationSpec.source,
+        targets: presentationSpec.targets
+      }, null, 2);
+      return {
+        contents: [
+          {
+            uri: baseUri,
+            mimeType: "application/json",
+            text: jsonText
+          }
+        ]
+      };
+    });
+    const variants = [{ ext: ".md", target: "markdown" }];
+    for (const v of variants) {
+      const key = `${baseKey}${v.ext}`;
+      const uri = `${baseUri}${v.ext}`;
+      server.registerResource(key, uri, {
+        title: `${presentationSpec.meta.key} v${presentationSpec.meta.version} (${v.ext})`,
+        description: `${presentationSpec.meta.description ?? "Presentation"} (${v.ext})`
+      }, async () => {
+        const out = await engine.render(v.target, presentationSpec);
+        const mimeType = isEngineRenderOutput(out) && out.mimeType ? out.mimeType : v.target === "markdown" ? "text/markdown" : v.target;
+        const text = isEngineRenderOutput(out) && typeof out.body === "string" ? out.body : String(out);
+        return { contents: [{ uri, mimeType, text }] };
+      });
+    }
+  }
+}
+
+// src/mcp/createMcpServer.ts
+function createMcpServer(server, ops, resources, prompts, ctxFactories) {
+  ctxFactories.logger.debug("Creating MCP server");
+  registerMcpTools(server, ops, { toolCtx: ctxFactories.toolCtx });
+  registerMcpResources(server, resources, {
+    logger: ctxFactories.logger,
+    resourceCtx: ctxFactories.resourceCtx
+  });
+  registerMcpPresentations(server, {
+    logger: ctxFactories.logger,
+    presentations: ctxFactories.presentations
+  });
+  registerMcpPrompts(server, prompts, { promptCtx: ctxFactories.promptCtx });
+  return server;
+}
+export {
+  createMcpServer
+};

package/dist/provider-mcp.d.ts

@@ -0,0 +1 @@
+export { createMcpServer } from './mcp/createMcpServer';

package/dist/provider-mcp.js

@@ -0,0 +1,182 @@
+// @bun
+// src/mcp/registerTools.ts
+import { defaultMcpTool } from "@contractspec/lib.contracts-spec/jsonschema";
+function registerMcpTools(server, ops, ctx) {
+  for (const spec of ops.list()) {
+    if (spec.meta.kind !== "command")
+      continue;
+    const toolName = spec.transport?.mcp?.toolName ?? defaultMcpTool(spec.meta.key, spec.meta.version);
+    server.registerTool(toolName, {
+      description: spec.meta.description,
+      inputSchema: spec.io.input?.getZod()
+    }, async (args) => {
+      const result = await ops.execute(spec.meta.key, spec.meta.version, args ?? {}, ctx.toolCtx());
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 4) }]
+      };
+    });
+  }
+}
+
+// src/mcp/registerResources.ts
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Buffer } from "buffer";
+function mcpResourceMeta(resource) {
+  return {
+    title: resource.meta.title,
+    description: resource.meta.description,
+    mimeType: resource.meta.mimeType,
+    _meta: { tags: resource.meta.tags ?? [] }
+  };
+}
+function registerMcpResources(server, resources, ctx) {
+  for (const resource of resources.listTemplates()) {
+    ctx.logger.debug("Registering resource: " + resource.meta.uriTemplate);
+    server.registerResource(resource.meta.uriTemplate, new ResourceTemplate(resource.meta.uriTemplate, { list: undefined }), mcpResourceMeta(resource), async (_uri, variables) => {
+      const parsedArgs = resource.input.parse(variables);
+      const out = await resource.resolve(parsedArgs, ctx.resourceCtx());
+      if (typeof out.data === "string") {
+        return {
+          contents: [
+            {
+              uri: out.uri,
+              mimeType: out.mimeType ?? resource.meta.mimeType,
+              text: out.data
+            }
+          ]
+        };
+      }
+      return {
+        contents: [
+          {
+            uri: out.uri,
+            mimeType: out.mimeType ?? resource.meta.mimeType,
+            blob: Buffer.from(out.data).toString("base64")
+          }
+        ]
+      };
+    });
+    ctx.logger.debug("Registered resource: " + resource.meta.uriTemplate);
+  }
+}
+
+// src/mcp/registerPrompts.ts
+import { defaultMcpPrompt } from "@contractspec/lib.contracts-spec/jsonschema";
+function promptArgsSchemaFromPromptArgs(args) {
+  const shape = {};
+  for (const a of args)
+    shape[a.name] = a.schema;
+  return shape;
+}
+function registerMcpPrompts(server, prompts, ctx) {
+  for (const prompt of prompts.list()) {
+    const promptName = defaultMcpPrompt(prompt.meta.key);
+    server.registerPrompt(promptName, {
+      title: prompt.meta.title,
+      description: prompt.meta.description,
+      argsSchema: promptArgsSchemaFromPromptArgs(prompt.args)
+    }, async (args) => {
+      const link = (tpl, vars) => {
+        let out = tpl;
+        for (const [k, v] of Object.entries(vars)) {
+          out = out.replace(new RegExp(`\\{${k}\\}`, "g"), encodeURIComponent(String(v)));
+        }
+        return out;
+      };
+      const parts = await prompt.render(prompt.input.parse(args), {
+        ...ctx.promptCtx(),
+        link
+      });
+      const text = parts.map((p) => p.type === "text" ? p.text : `See resource: ${p.title ?? p.uri}
+URI: ${p.uri}`).join(`
+
+`);
+      const contents = {
+        type: "text",
+        text
+      };
+      return {
+        messages: [{ role: "assistant", content: contents }],
+        description: prompt.meta.description
+      };
+    });
+  }
+}
+
+// src/mcp/registerPresentations.ts
+import"@contractspec/lib.contracts-spec/presentations";
+import {
+  createDefaultTransformEngine,
+  registerBasicValidation,
+  registerDefaultReactRenderer
+} from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import { sanitizeMcpName } from "@contractspec/lib.contracts-spec/jsonschema";
+function isEngineRenderOutput(x) {
+  if (!x || typeof x !== "object")
+    return false;
+  return "body" in x && typeof x.body === "string";
+}
+function registerMcpPresentations(server, ctx) {
+  if (!ctx.presentations?.count()) {
+    return;
+  }
+  const engine = registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
+  for (const presentationSpec of ctx.presentations.list()) {
+    const baseKey = sanitizeMcpName(`presentation_${presentationSpec.meta.key}_v${presentationSpec.meta.version}`);
+    const baseUri = `presentation://${presentationSpec.meta.key}/v${presentationSpec.meta.version}`;
+    ctx.logger.debug(`Registering presentation ${baseUri} for ${baseKey}`);
+    server.registerResource(baseKey, baseUri, {
+      title: `${presentationSpec.meta.key} v${presentationSpec.meta.version}`,
+      description: presentationSpec.meta.description ?? "Presentation",
+      mimeType: "application/json"
+    }, async () => {
+      const jsonText = JSON.stringify({
+        meta: presentationSpec.meta,
+        source: presentationSpec.source,
+        targets: presentationSpec.targets
+      }, null, 2);
+      return {
+        contents: [
+          {
+            uri: baseUri,
+            mimeType: "application/json",
+            text: jsonText
+          }
+        ]
+      };
+    });
+    const variants = [{ ext: ".md", target: "markdown" }];
+    for (const v of variants) {
+      const key = `${baseKey}${v.ext}`;
+      const uri = `${baseUri}${v.ext}`;
+      server.registerResource(key, uri, {
+        title: `${presentationSpec.meta.key} v${presentationSpec.meta.version} (${v.ext})`,
+        description: `${presentationSpec.meta.description ?? "Presentation"} (${v.ext})`
+      }, async () => {
+        const out = await engine.render(v.target, presentationSpec);
+        const mimeType = isEngineRenderOutput(out) && out.mimeType ? out.mimeType : v.target === "markdown" ? "text/markdown" : v.target;
+        const text = isEngineRenderOutput(out) && typeof out.body === "string" ? out.body : String(out);
+        return { contents: [{ uri, mimeType, text }] };
+      });
+    }
+  }
+}
+
+// src/mcp/createMcpServer.ts
+function createMcpServer(server, ops, resources, prompts, ctxFactories) {
+  ctxFactories.logger.debug("Creating MCP server");
+  registerMcpTools(server, ops, { toolCtx: ctxFactories.toolCtx });
+  registerMcpResources(server, resources, {
+    logger: ctxFactories.logger,
+    resourceCtx: ctxFactories.resourceCtx
+  });
+  registerMcpPresentations(server, {
+    logger: ctxFactories.logger,
+    presentations: ctxFactories.presentations
+  });
+  registerMcpPrompts(server, prompts, { promptCtx: ctxFactories.promptCtx });
+  return server;
+}
+export {
+  createMcpServer
+};

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "@contractspec/lib.contracts-runtime-server-mcp",
+  "version": "2.0.0",
+  "description": "MCP server runtime adapters for ContractSpec contracts",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "clean": "rm -rf dist",
+    "lint": "bun run lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit",
+    "dev": "contractspec-bun-build dev"
+  },
+  "dependencies": {
+    "@contractspec/lib.contracts-spec": "2.0.0",
+    "@contractspec/lib.logger": "2.0.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@contractspec/tool.typescript": "2.0.0",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "2.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./dist/index.js",
+      "node": "./dist/node/index.js",
+      "default": "./dist/index.js"
+    },
+    "./mcp/createMcpServer": {
+      "types": "./dist/mcp/createMcpServer.d.ts",
+      "bun": "./dist/mcp/createMcpServer.js",
+      "node": "./dist/node/mcp/createMcpServer.js",
+      "default": "./dist/mcp/createMcpServer.js"
+    },
+    "./mcp/mcpTypes": {
+      "types": "./dist/mcp/mcpTypes.d.ts",
+      "bun": "./dist/mcp/mcpTypes.js",
+      "node": "./dist/node/mcp/mcpTypes.js",
+      "default": "./dist/mcp/mcpTypes.js"
+    },
+    "./mcp/registerPresentations": {
+      "types": "./dist/mcp/registerPresentations.d.ts",
+      "bun": "./dist/mcp/registerPresentations.js",
+      "node": "./dist/node/mcp/registerPresentations.js",
+      "default": "./dist/mcp/registerPresentations.js"
+    },
+    "./mcp/registerPrompts": {
+      "types": "./dist/mcp/registerPrompts.d.ts",
+      "bun": "./dist/mcp/registerPrompts.js",
+      "node": "./dist/node/mcp/registerPrompts.js",
+      "default": "./dist/mcp/registerPrompts.js"
+    },
+    "./mcp/registerResources": {
+      "types": "./dist/mcp/registerResources.d.ts",
+      "bun": "./dist/mcp/registerResources.js",
+      "node": "./dist/node/mcp/registerResources.js",
+      "default": "./dist/mcp/registerResources.js"
+    },
+    "./mcp/registerTools": {
+      "types": "./dist/mcp/registerTools.d.ts",
+      "bun": "./dist/mcp/registerTools.js",
+      "node": "./dist/node/mcp/registerTools.js",
+      "default": "./dist/mcp/registerTools.js"
+    },
+    "./provider-mcp": {
+      "types": "./dist/provider-mcp.d.ts",
+      "bun": "./dist/provider-mcp.js",
+      "node": "./dist/node/provider-mcp.js",
+      "default": "./dist/provider-mcp.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.js",
+        "default": "./dist/index.js"
+      },
+      "./mcp/createMcpServer": {
+        "types": "./dist/mcp/createMcpServer.d.ts",
+        "bun": "./dist/mcp/createMcpServer.js",
+        "node": "./dist/node/mcp/createMcpServer.js",
+        "default": "./dist/mcp/createMcpServer.js"
+      },
+      "./mcp/mcpTypes": {
+        "types": "./dist/mcp/mcpTypes.d.ts",
+        "bun": "./dist/mcp/mcpTypes.js",
+        "node": "./dist/node/mcp/mcpTypes.js",
+        "default": "./dist/mcp/mcpTypes.js"
+      },
+      "./mcp/registerPresentations": {
+        "types": "./dist/mcp/registerPresentations.d.ts",
+        "bun": "./dist/mcp/registerPresentations.js",
+        "node": "./dist/node/mcp/registerPresentations.js",
+        "default": "./dist/mcp/registerPresentations.js"
+      },
+      "./mcp/registerPrompts": {
+        "types": "./dist/mcp/registerPrompts.d.ts",
+        "bun": "./dist/mcp/registerPrompts.js",
+        "node": "./dist/node/mcp/registerPrompts.js",
+        "default": "./dist/mcp/registerPrompts.js"
+      },
+      "./mcp/registerResources": {
+        "types": "./dist/mcp/registerResources.d.ts",
+        "bun": "./dist/mcp/registerResources.js",
+        "node": "./dist/node/mcp/registerResources.js",
+        "default": "./dist/mcp/registerResources.js"
+      },
+      "./mcp/registerTools": {
+        "types": "./dist/mcp/registerTools.d.ts",
+        "bun": "./dist/mcp/registerTools.js",
+        "node": "./dist/node/mcp/registerTools.js",
+        "default": "./dist/mcp/registerTools.js"
+      },
+      "./provider-mcp": {
+        "types": "./dist/provider-mcp.d.ts",
+        "bun": "./dist/provider-mcp.js",
+        "node": "./dist/node/provider-mcp.js",
+        "default": "./dist/provider-mcp.js"
+      }
+    }
+  }
+}