@uluops/registry-mcp 0.1.0

package/dist/utils/tool-handler.js

@@ -0,0 +1,184 @@
+/**
+ * Tool handler factory
+ *
+ * Creates standardized MCP tool handlers with consistent error handling.
+ * Eliminates boilerplate across tool implementations.
+ */
+import { z } from 'zod';
+import { mapSdkErrorToMcp, mapZodErrorToMcp } from '../client/sdk-error-mapper.js';
+import { normalizeKeys } from './normalize-keys.js';
+import { createSuccessResponse } from '../types/index.js';
+import { getDefaultType } from './session-state.js';
+/**
+ * Coerce string values to numbers for fields that the Zod schema expects as numeric.
+ * MCP JSON-RPC sometimes serializes numeric parameters as strings (e.g., "50" instead of 50).
+ * This runs before Zod validation to prevent spurious type errors at the boundary.
+ */
+function coerceNumericFields(args, schema) {
+    if (typeof args !== 'object' || args === null)
+        return args;
+    if (!(schema instanceof z.ZodObject))
+        return args;
+    const shape = schema.shape;
+    const obj = { ...args };
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        if (key in obj && typeof obj[key] === 'string') {
+            if (isNumericSchema(fieldSchema)) {
+                const num = Number(obj[key]);
+                if (!isNaN(num)) {
+                    obj[key] = num;
+                }
+            }
+        }
+    }
+    return obj;
+}
+/** Check if a Zod schema (possibly wrapped in optional/nullable/default) expects a number. */
+function isNumericSchema(schema) {
+    if (schema instanceof z.ZodNumber)
+        return true;
+    if (schema instanceof z.ZodOptional || schema instanceof z.ZodNullable || schema instanceof z.ZodDefault) {
+        return isNumericSchema(schema._def.innerType);
+    }
+    return false;
+}
+/** Type guard: checks if a value is a complete MCP tool response (has content array). */
+function isMcpToolResponse(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'content' in value &&
+        Array.isArray(value.content));
+}
+/**
+ * Creates a standardized tool handler with Zod validation, key normalization,
+ * and SDK error mapping.
+ *
+ * All handlers follow the same flow:
+ * 1. Parse input with Zod schema (validates snake_case MCP input)
+ * 2. Normalize keys from snake_case -> camelCase for SDK
+ * 3. Call SDK method with normalized input
+ * 4. Return success response or mapped error
+ *
+ * Timeout enforcement is handled by the RegistryClient SDK (configured via
+ * ULUOPS_REGISTRY_TIMEOUT env var, default 30s). No additional timeout is
+ * needed at this layer.
+ */
+export function createToolHandler(schema, sdkCall, options) {
+    return async (args) => {
+        try {
+            // Extract fields param before Zod parse (meta-parameter, not part of tool schemas)
+            const { cleanArgs, fields } = extractFieldsParam(args);
+            // Inject session-level default type if not explicitly provided
+            const injectedArgs = injectSessionType(cleanArgs);
+            let input = schema.parse(coerceNumericFields(injectedArgs, schema));
+            if (options?.preProcess) {
+                const preResult = options.preProcess(input);
+                if (isMcpToolResponse(preResult)) {
+                    return preResult;
+                }
+                input = preResult;
+            }
+            const normalized = normalizeKeys(input);
+            let result = await sdkCall(normalized);
+            if (options?.postProcess) {
+                result = options.postProcess(result);
+            }
+            // Apply field selection after all processing
+            if (fields) {
+                result = filterResponseFields(result, fields);
+            }
+            return createSuccessResponse(result);
+        }
+        catch (error) {
+            // Log errors to stderr for debugging (MCP transport uses stdout)
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            const errorType = error instanceof z.ZodError ? 'validation' :
+                error instanceof Error ? error.constructor.name : 'unknown';
+            process.stderr.write(`[mcp-tool-error] type=${errorType} message=${errorMsg.slice(0, 200)}\n`);
+            if (error instanceof z.ZodError) {
+                return mapZodErrorToMcp(error);
+            }
+            return mapSdkErrorToMcp(error);
+        }
+    };
+}
+/**
+ * Inject session-level default type into args if not explicitly provided.
+ * Safe for blanket injection — Zod strips unknown keys from tools that don't declare `type`.
+ */
+export function injectSessionType(args) {
+    const sessionType = getDefaultType();
+    if (!sessionType)
+        return args;
+    if (typeof args === 'object' && args !== null) {
+        const obj = args;
+        if (obj.type === undefined || obj.type === null) {
+            return { ...obj, type: sessionType };
+        }
+    }
+    return args;
+}
+/**
+ * Extract the `fields` meta-parameter from raw args before Zod validation.
+ * Removes it from the args so Zod doesn't reject it as an unknown key.
+ */
+export function extractFieldsParam(args) {
+    if (typeof args !== 'object' || args === null) {
+        return { cleanArgs: args, fields: undefined };
+    }
+    const obj = args;
+    if (!('fields' in obj) || !Array.isArray(obj.fields)) {
+        return { cleanArgs: args, fields: undefined };
+    }
+    const fields = obj.fields.filter((f) => typeof f === 'string');
+    const rest = Object.fromEntries(Object.entries(obj).filter(([k]) => k !== 'fields'));
+    if (fields.length === 0) {
+        return { cleanArgs: rest, fields: undefined };
+    }
+    return { cleanArgs: rest, fields };
+}
+/** Keys that represent pagination metadata and are always preserved. */
+const PAGINATION_KEYS = new Set(['total', 'limit', 'offset', 'hasMore', 'page', 'totalPages']);
+/**
+ * Filter response fields to only include requested properties.
+ * Preserves pagination metadata. For array properties, picks fields from each item.
+ */
+export function filterResponseFields(data, fields) {
+    if (typeof data !== 'object' || data === null)
+        return data;
+    const obj = data;
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        // Always preserve pagination metadata
+        if (PAGINATION_KEYS.has(key)) {
+            result[key] = value;
+            continue;
+        }
+        // For array values, pick fields from each item
+        if (Array.isArray(value)) {
+            result[key] = value.map((item) => {
+                if (typeof item === 'object' && item !== null) {
+                    return pickFields(item, fields);
+                }
+                return item;
+            });
+            continue;
+        }
+        // Include top-level keys that match the fields list
+        if (fields.includes(key)) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/** Pick specified fields from an object. */
+function pickFields(obj, fields) {
+    const result = {};
+    for (const field of fields) {
+        if (field in obj) {
+            result[field] = obj[field];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=tool-handler.js.map

package/dist/utils/tool-handler.js.map

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

package/dist/utils/trim-definition.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Trims large fields from definition responses to reduce token consumption.
+ *
+ * MCP responses containing full YAML and rendered markdown can exceed 16k tokens
+ * per call. For mutation operations (create, update, publish, deprecate), the caller
+ * already has the YAML — returning it wastes context window.
+ */
+/**
+ * Replace `yaml` and `runtimeMd` with short previews in a definition response.
+ * Preserves all other fields (status, version, hash, etc.) untouched.
+ */
+export declare function trimDefinitionResponse(data: unknown): unknown;
+//# sourceMappingURL=trim-definition.d.ts.map

package/dist/utils/trim-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-definition.d.ts","sourceRoot":"","sources":["../../src/utils/trim-definition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAiB7D"}

package/dist/utils/trim-definition.js

@@ -0,0 +1,28 @@
+/**
+ * Trims large fields from definition responses to reduce token consumption.
+ *
+ * MCP responses containing full YAML and rendered markdown can exceed 16k tokens
+ * per call. For mutation operations (create, update, publish, deprecate), the caller
+ * already has the YAML — returning it wastes context window.
+ */
+const PREVIEW_LENGTH = 25;
+/**
+ * Replace `yaml` and `runtimeMd` with short previews in a definition response.
+ * Preserves all other fields (status, version, hash, etc.) untouched.
+ */
+export function trimDefinitionResponse(data) {
+    if (typeof data !== 'object' || data === null)
+        return data;
+    const record = data;
+    const trimmed = { ...record };
+    if (typeof trimmed.yaml === 'string') {
+        const len = trimmed.yaml.length;
+        trimmed.yaml = `${trimmed.yaml.slice(0, PREVIEW_LENGTH)}... (${String(len)} chars)`;
+    }
+    if (typeof trimmed.runtimeMd === 'string') {
+        const len = trimmed.runtimeMd.length;
+        trimmed.runtimeMd = `${trimmed.runtimeMd.slice(0, PREVIEW_LENGTH)}... (${String(len)} chars)`;
+    }
+    return trimmed;
+}
+//# sourceMappingURL=trim-definition.js.map

package/dist/utils/trim-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-definition.js","sourceRoot":"","sources":["../../src/utils/trim-definition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAClD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE3D,MAAM,MAAM,GAAG,IAA+B,CAAC;IAC/C,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAE9B,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,OAAO,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,QAAQ,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;IACtF,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC;QACrC,OAAO,CAAC,SAAS,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,QAAQ,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;IAChG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@uluops/registry-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the UluOps Registry API — definition management, versioning, and analytics",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "uluops-registry-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "tool-policies.json",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "postbuild": "chmod +x dist/index.js",
+    "lint": "eslint src/",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run lint && npm test && npm audit --audit-level=high --omit=dev && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "uluops",
+    "registry",
+    "definitions",
+    "claude",
+    "claude-code",
+    "model-context-protocol"
+  ],
+  "author": "aself101",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Uluops/-uluops-registry-mcp.git"
+  },
+  "homepage": "https://github.com/Uluops/-uluops-registry-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/Uluops/-uluops-registry-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@uluops/definition-factory": "^0.36.0",
+    "@uluops/registry-sdk": "0.30.1",
+    "@uluops/sdk-core": "0.11.0",
+    "mcp-secure-server": "^0.0.14-security",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^22.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@vitest/coverage-v8": "^4.1.8",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.52.0",
+    "vitest": "^4.1.8"
+  }
+}

package/tool-policies.json

@@ -0,0 +1,66 @@
+{
+  "version": "2.0",
+  "tools": {
+    "validate_definition": {
+      "level": "STORAGE",
+      "relaxedFields": ["yaml"],
+      "description": "Validates YAML content - may contain code-like structures"
+    },
+    "create_definition": {
+      "level": "STORAGE",
+      "relaxedFields": ["yaml", "description", "tags"],
+      "description": "Creates definitions with YAML content that may contain code patterns"
+    },
+    "update_definition": {
+      "level": "STORAGE",
+      "relaxedFields": ["yaml", "description", "tags"],
+      "description": "Updates definitions with YAML content that may contain code patterns"
+    },
+    "render_definition": {
+      "level": "QUERY",
+      "relaxedFields": [],
+      "description": "Renders definition markdown"
+    },
+    "upgrade_definition": {
+      "level": "STORAGE",
+      "relaxedFields": ["yaml", "source_format"],
+      "description": "Upgrades legacy YAML format - may contain code patterns"
+    },
+    "deprecate_definition": {
+      "level": "STORAGE",
+      "relaxedFields": ["reason", "successor"],
+      "description": "Deprecation reason may contain technical references"
+    },
+    "fork_definition": {
+      "level": "STORAGE",
+      "relaxedFields": ["new_name", "description"],
+      "description": "Fork definition with user-provided names"
+    },
+    "update_and_publish": {
+      "level": "STORAGE",
+      "relaxedFields": ["yaml", "description", "tags"],
+      "description": "Composite update+publish with YAML content that may contain code patterns"
+    },
+    "batch_publish": {
+      "level": "QUERY",
+      "relaxedFields": [],
+      "description": "Batch publish multiple definitions by reference"
+    },
+    "record_execution": {
+      "level": "STORAGE",
+      "relaxedFields": ["idempotency_key"],
+      "description": "Records execution with idempotency key"
+    },
+    "get_user": {
+      "level": "QUERY",
+      "relaxedFields": ["id"],
+      "description": "User ID lookup - UUID format can trigger false positives"
+    },
+    "batch_users": {
+      "level": "QUERY",
+      "relaxedFields": ["ids"],
+      "description": "Batch user IDs - UUIDs can trigger false positives"
+    }
+  },
+  "defaultLevel": "QUERY"
+}