mcp-layer 0.1.0 → 0.2.0

package/README.md

@@ -2,10 +2,22 @@
 
 `mcp-layer` helps engineers bolt extra behaviors on top of existing MCP servers without reimplementing transport or schema parsing. It is a small, focused toolbox for discovering MCP configs, connecting to servers, and extracting a unified schema that can drive CLIs, REST APIs, UI renderers, or additional MCP layers.
 
+## Table of Contents
+
+- [What you can build with this repo](#what-you-can-build-with-this-repo)
+- [Packages](#packages)
+- [CLI quick try](#cli-quick-try)
+- [Quick start (end-to-end)](#quick-start-end-to-end)
+- [Design principles](#design-principles)
+- [Development](#development)
+- [Releasing](#releasing)
+- [Repository guidelines](#repository-guidelines)
+
 ## What you can build with this repo
 
 - **CLI layers** that expose MCP tools as commands with validated input.
 - **REST gateways** that generate endpoints and schemas from MCP tool definitions.
+- **GraphQL gateways** that expose generated and generic operations on top of MCP catalogs.
 - **UI renderers** that surface MCP Apps resources using `_meta.ui` metadata.
 - **New MCP layers** that programmatically reason about tool/resource catalogs.
 
@@ -33,6 +45,7 @@ await link.close();
 | [`@mcp-layer/connect`](packages/connect/README.md) | Connect to MCP servers over stdio and return a closeable Session. |
 | [`@mcp-layer/attach`](packages/attach/README.md) | Attach to in-process MCP SDK servers or Platformatic Fastify MCP plugins and return a Session. |
 | [`@mcp-layer/schema`](packages/schema/README.md) | Extract tools/resources/prompts/templates into a unified Zod-backed schema (including MCP Apps metadata). |
+| [`@mcp-layer/gateway`](packages/gateway/README.md) | Shared adapter runtime primitives for catalog bootstrap, validation, resilience, telemetry, and deterministic mapping. |
 | [`@mcp-layer/test-server`](packages/test-server/README.md) | Feature-complete MCP server for integration tests and local exploration. |
 | [`@mcp-layer/openapi`](packages/openapi/README.md) | Generate OpenAPI 3.1 specs from MCP catalogs. |
 | [`@mcp-layer/rest`](packages/rest/README.md) | Fastify plugin that exposes MCP servers over REST. |
@@ -44,6 +57,7 @@ await link.close();
 | [`@mcp-layer/cli`](packages/cli/README.md) | CLI framework for turning MCP schemas into commands. |
 | [`@mcp-layer/openapi`](packages/openapi/README.md) | OpenAPI 3.1 generation for REST surfaces. |
 | [`@mcp-layer/rest`](packages/rest/README.md) | Fastify plugin for HTTP REST exposure. |
+| [`@mcp-layer/graphql`](packages/graphql/README.md) | Fastify plugin and schema builder for GraphQL exposure on MCP catalogs. |
 
 ## CLI quick try
 
@@ -74,6 +88,7 @@ await session.close();
 ## Design principles
 
 - **Single source of truth**: normalized schemas flow from the MCP server, not from tool-specific parsing.
+- **Layered adapters**: `schema -> gateway -> rest/graphql` keeps protocol logic centralized while adapters stay thin.
 - **Minimal surface area**: each package does one job and composes cleanly with the others.
 - **Real integration tests**: no mocks; the test server is used as a real MCP target.
 
@@ -98,6 +113,8 @@ The root package runs `prepack` to regenerate `src/index.js` and sync root `pack
 
 See `.github/workflows/release.yml` for the pipeline details.
 
+The publish guard at `.github/workflows/publish-guard.yml` runs after the `Release` workflow completes and locates the open `Version Packages` PR (`changeset-release/main`). It checks npm for workspace package existence and upserts a single PR comment when packages still need first-time bootstrap publishing.
+
 ## Repository guidelines
 
 See `AGENTS.md` for coding style, testing requirements, and documentation expectations.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-layer",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Layers of functionality that can be add to any MCP server. ",
   "repository": {
     "type": "git",
@@ -29,15 +29,19 @@
     "@changesets/cli": "^2.29.2"
   },
   "dependencies": {
-    "@mcp-layer/attach": "1.1.0",
-    "@mcp-layer/cli": "1.1.0",
-    "@mcp-layer/config": "1.0.0",
-    "@mcp-layer/connect": "1.0.0",
-    "@mcp-layer/openapi": "1.1.0",
-    "@mcp-layer/rest": "1.1.0",
-    "@mcp-layer/schema": "1.0.1",
+    "@mcp-layer/attach": "1.1.1",
+    "@mcp-layer/cli": "1.1.1",
+    "@mcp-layer/config": "1.0.1",
+    "@mcp-layer/connect": "1.0.1",
+    "@mcp-layer/error": "0.2.0",
+    "@mcp-layer/gateway": "0.2.0",
+    "@mcp-layer/graphql": "0.2.0",
+    "@mcp-layer/manager": "0.2.0",
+    "@mcp-layer/openapi": "1.1.1",
+    "@mcp-layer/rest": "1.2.1",
+    "@mcp-layer/schema": "1.0.2",
     "@mcp-layer/session": "1.0.0",
-    "@mcp-layer/test-server": "1.0.0"
+    "@mcp-layer/test-server": "1.0.1"
   },
   "main": "./src/index.js",
   "files": [

package/src/generate.js

@@ -24,16 +24,12 @@ export async function collectPackages(rootDir) {
   const packages = [];
 
   for (const entry of entries) {
-    if (!entry.isDirectory()) {
-      continue;
-    }
+    if (!entry.isDirectory()) continue;
 
     const pkgPath = path.join(packagesDir, entry.name, 'package.json');
     const exists = await hasPackageJson(pkgPath);
 
-    if (exists) {
-      packages.push(entry.name);
-    }
+    if (exists) packages.push(entry.name);
   }
 
   packages.sort();
@@ -121,9 +117,7 @@ export async function syncDependencies(rootDir) {
   }
 
   for (const key of Object.keys(deps)) {
-    if (key.startsWith('@mcp-layer/') && !names.has(key)) {
-      delete deps[key];
-    }
+    if (key.startsWith('@mcp-layer/') && !names.has(key)) delete deps[key];
   }
 
   data.dependencies = sortObject(deps);
@@ -140,9 +134,7 @@ export async function writeIndex(rootDir, outFile) {
   const next = await buildIndex(rootDir);
   const current = await readMaybe(outFile);
 
-  if (current === next) {
-    return;
-  }
+  if (current === next) return;
 
   await writeFile(outFile, next, 'utf8');
 }
@@ -180,9 +172,7 @@ export async function writeJson(filePath, data) {
   const next = `${JSON.stringify(data, null, 2)}\n`;
   const current = await readMaybe(filePath);
 
-  if (current === next) {
-    return;
-  }
+  if (current === next) return;
 
   await writeFile(filePath, next, 'utf8');
 }
@@ -216,6 +206,4 @@ export async function run() {
 }
 
 const entry = fileURLToPath(import.meta.url);
-if (process.argv[1] === entry) {
-  run();
-}
+if (process.argv[1] === entry) run();

package/src/index.js

@@ -28,6 +28,30 @@ export * as config from '@mcp-layer/config';
  */
 export * as connect from '@mcp-layer/connect';
 
+/**
+ * Package namespace from `@mcp-layer/error`.
+ * @type {typeof import('@mcp-layer/error')}
+ */
+export * as error from '@mcp-layer/error';
+
+/**
+ * Package namespace from `@mcp-layer/gateway`.
+ * @type {typeof import('@mcp-layer/gateway')}
+ */
+export * as gateway from '@mcp-layer/gateway';
+
+/**
+ * Package namespace from `@mcp-layer/graphql`.
+ * @type {typeof import('@mcp-layer/graphql')}
+ */
+export * as graphql from '@mcp-layer/graphql';
+
+/**
+ * Package namespace from `@mcp-layer/manager`.
+ * @type {typeof import('@mcp-layer/manager')}
+ */
+export * as manager from '@mcp-layer/manager';
+
 /**
  * Package namespace from `@mcp-layer/openapi`.
  * @type {typeof import('@mcp-layer/openapi')}