@ratio-mcp-qa/docs-server 1.0.1

package/dist/utils/schema-loader.js

@@ -0,0 +1,61 @@
+import { readFileSync, readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { logger } from './logger.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Path to schemas directory (relative to this file's location in dist/utils/)
+ */
+const SCHEMAS_DIR = join(__dirname, '..', 'schemas');
+/**
+ * In-memory cache for loaded schemas
+ */
+const cache = new Map();
+function loadJson(filename) {
+    const cached = cache.get(filename);
+    if (cached)
+        return cached;
+    const filePath = join(SCHEMAS_DIR, filename);
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        cache.set(filename, parsed);
+        logger.debug(`Loaded schema: ${filename}`);
+        return parsed;
+    }
+    catch (err) {
+        logger.error(`Failed to load schema: ${filename}`, err);
+        throw new Error(`Schema not found: ${filename}`);
+    }
+}
+export function loadResourceSchema(resource) {
+    return loadJson(`${resource}.json`);
+}
+export function loadWebhooks() {
+    return loadJson('webhooks.json');
+}
+export function loadOAuth() {
+    return loadJson('oauth.json');
+}
+/**
+ * Get list of available resource schema files (excludes oauth.json and webhooks.json)
+ */
+export function getAvailableResourceFiles() {
+    const EXCLUDED = ['oauth.json', 'webhooks.json'];
+    try {
+        return readdirSync(SCHEMAS_DIR)
+            .filter((f) => f.endsWith('.json') && !EXCLUDED.includes(f))
+            .map((f) => f.replace('.json', ''));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Clear the cache (useful for testing)
+ */
+export function clearCache() {
+    cache.clear();
+}
+//# sourceMappingURL=schema-loader.js.map

package/dist/utils/schema-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-loader.js","sourceRoot":"","sources":["../../src/utils/schema-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;AAEzC,SAAS,QAAQ,CAAI,QAAgB;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,MAAM;QAAE,OAAO,MAAW,CAAC;IAE/B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QACpC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,0BAA0B,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,QAAQ,CAAiB,GAAG,QAAQ,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,QAAQ,CAAiB,eAAe,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,QAAQ,CAAc,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,QAAQ,GAAG,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,WAAW,CAAC;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;aAC3D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/utils/zod-to-json.d.ts

@@ -0,0 +1,7 @@
+import type { z } from 'zod';
+/**
+ * Simple Zod-to-JSON-Schema converter for MCP tool registration.
+ * Handles the common cases used in our tool definitions.
+ */
+export declare function zodToJsonSchema(schema: z.ZodType): Record<string, unknown>;
+//# sourceMappingURL=zod-to-json.d.ts.map

package/dist/utils/zod-to-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json.d.ts","sourceRoot":"","sources":["../../src/utils/zod-to-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE1E"}

package/dist/utils/zod-to-json.js

@@ -0,0 +1,63 @@
+/**
+ * Simple Zod-to-JSON-Schema converter for MCP tool registration.
+ * Handles the common cases used in our tool definitions.
+ */
+export function zodToJsonSchema(schema) {
+    return convertZodType(schema);
+}
+function convertZodType(schema) {
+    const def = schema._def;
+    const typeName = def.typeName;
+    switch (typeName) {
+        case 'ZodObject': {
+            const shape = schema.shape;
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(shape)) {
+                const fieldDef = value._def;
+                const isOptional = fieldDef.typeName === 'ZodOptional';
+                const innerType = isOptional ? fieldDef.innerType : value;
+                properties[key] = convertZodType(innerType);
+                // Add description from .describe()
+                const desc = fieldDef.description || innerType._def.description;
+                if (desc) {
+                    properties[key].description = desc;
+                }
+                if (!isOptional) {
+                    required.push(key);
+                }
+            }
+            const result = { type: 'object', properties };
+            if (required.length > 0)
+                result.required = required;
+            return result;
+        }
+        case 'ZodString':
+            return { type: 'string' };
+        case 'ZodNumber':
+            return { type: 'number' };
+        case 'ZodBoolean':
+            return { type: 'boolean' };
+        case 'ZodArray': {
+            const itemType = def.type || def.innerType;
+            return { type: 'array', items: convertZodType(itemType) };
+        }
+        case 'ZodEnum': {
+            const values = def.values;
+            return { type: 'string', enum: values };
+        }
+        case 'ZodOptional': {
+            const inner = def.innerType;
+            return convertZodType(inner);
+        }
+        case 'ZodDefault': {
+            const inner = def.innerType;
+            const result = convertZodType(inner);
+            result.default = def.defaultValue;
+            return result;
+        }
+        default:
+            return { type: 'string' };
+    }
+}
+//# sourceMappingURL=zod-to-json.js.map

package/dist/utils/zod-to-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json.js","sourceRoot":"","sources":["../../src/utils/zod-to-json.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,cAAc,CAAC,MAAiB;IACvC,MAAM,GAAG,GAAI,MAAuD,CAAC,IAAI,CAAC;IAC1E,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAkB,CAAC;IAExC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAI,MAAiD,CAAC,KAAK,CAAC;YACvE,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;YAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,QAAQ,GAAI,KAAsD,CAAC,IAAI,CAAC;gBAC9E,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,KAAK,aAAa,CAAC;gBACvD,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAE,QAAQ,CAAC,SAAuB,CAAC,CAAC,CAAE,KAAmB,CAAC;gBAExF,UAAU,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;gBAE5C,mCAAmC;gBACnC,MAAM,IAAI,GAAI,QAAQ,CAAC,WAAsB,IAAM,SAA0D,CAAC,IAAI,CAAC,WAAsB,CAAC;gBAC1I,IAAI,IAAI,EAAE,CAAC;oBACR,UAAU,CAAC,GAAG,CAA6B,CAAC,WAAW,GAAG,IAAI,CAAC;gBAClE,CAAC;gBAED,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;YACvE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACpD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAE5B,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAE5B,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAE7B,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,QAAQ,GAAI,GAAG,CAAC,IAAkB,IAAK,GAAG,CAAC,SAAuB,CAAC;YACzE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,CAAC;QAED,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,MAAM,GAAG,GAAG,CAAC,MAAkB,CAAC;YACtC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QAED,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,GAAG,GAAG,CAAC,SAAsB,CAAC;YACzC,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,KAAK,GAAG,GAAG,CAAC,SAAsB,CAAC;YACzC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC;YAClC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED;YACE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@ratio-mcp-qa/docs-server",
+  "version": "1.0.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": ["dist"],
+  "bin": {
+    "ratio-docs-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && cp -r src/schemas dist/schemas",
+    "dev": "node --loader ts-node/esm src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@ratio-mcp-qa/shared": "^1.0.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  }
+}