@mcpmake/core 0.2.0

package/dist/transformer/stainless-translator.js

@@ -0,0 +1,375 @@
+const HTTP_METHODS = new Set(['get', 'post', 'put', 'patch', 'delete', 'head', 'options']);
+/**
+ * Mutates `api` in place (adding `x-mcp-*` extensions) and returns the derived
+ * generation knobs + migration report.
+ */
+export function translateStainless(config, api) {
+    const warnings = [];
+    const report = [];
+    const toolNames = {};
+    const skipped = [];
+    const unwrapped = [];
+    // Distinct resources can singularize to the same name (e.g. `users` and
+    // `user`, both → `list_user`). buildAllTools' collision handler only appends
+    // the HTTP method, which still collides when the verb matches — so make the
+    // names we assign unique up front by suffixing `_2`, `_3`, …
+    const assignedNames = new Set();
+    const claimName = (base) => {
+        let name = base;
+        for (let n = 2; assignedNames.has(name); n++)
+            name = `${base}_${n}`;
+        assignedNames.add(name);
+        return name;
+    };
+    // 1. Resource-tree-driven naming → x-mcp-name (the headline parity item).
+    if (config.resources && typeof config.resources === 'object') {
+        walkResources(config.resources, [], (methodName, value, chain) => {
+            const ptr = parseMethodPointer(value);
+            const op = locateOperation(api, ptr);
+            if (!op) {
+                warnings.push(`Resource method "${chain.join('.')}.${methodName}" did not match any operation in the spec — skipped.`);
+                return;
+            }
+            const key = ptr.method && ptr.path ? `${ptr.method.toUpperCase()} ${ptr.path}` : opKey(op);
+            if (isMethodSkipped(value)) {
+                op['x-mcp-emit'] = 'skip';
+                skipped.push(key);
+                return;
+            }
+            const derived = toolNameFromTree(methodName, chain);
+            if (derived && !op['x-mcp-name']) {
+                const name = claimName(derived);
+                op['x-mcp-name'] = name;
+                toolNames[key] = name;
+            }
+        });
+    }
+    // 1b. Fallback: resource/method encoded as `x-stainless-*` operation extensions
+    // (common when the tree lives in the spec rather than the config).
+    forEachOperation(api, (op, method, path) => {
+        const key = `${method.toUpperCase()} ${path}`;
+        const sResource = typeof op['x-stainless-resource'] === 'string'
+            ? op['x-stainless-resource']
+            : undefined;
+        const sMethod = typeof op['x-stainless-method-name'] === 'string'
+            ? op['x-stainless-method-name']
+            : undefined;
+        if (isStainlessSkipped(op)) {
+            if (op['x-mcp-emit'] !== 'skip') {
+                op['x-mcp-emit'] = 'skip';
+                skipped.push(key);
+            }
+            return;
+        }
+        if (sResource && sMethod && !op['x-mcp-name']) {
+            const derived = toolNameFromTree(sMethod, sResource.split('.').filter(Boolean));
+            if (derived) {
+                const name = claimName(derived);
+                op['x-mcp-name'] = name;
+                toolNames[key] = name;
+            }
+        }
+    });
+    // 2. unwrap_response → x-mcp-jq-filter on the success response.
+    const unwrap = config.settings?.unwrap_response;
+    if (unwrap) {
+        // A string names the envelope property. Validate it to a safe dotted path —
+        // the value is emitted into a generated `applyJqFilter(result, '.<prop>')`
+        // call, so reject anything that could break out of that string literal.
+        let explicitProp;
+        if (typeof unwrap === 'string') {
+            const candidate = unwrap.replace(/^\./, '').trim();
+            if (/^[A-Za-z0-9_.]+$/.test(candidate)) {
+                explicitProp = candidate;
+            }
+            else {
+                warnings.push(`Ignoring settings.unwrap_response "${unwrap}" — not a simple property path ([A-Za-z0-9_.]).`);
+            }
+        }
+        if (typeof unwrap !== 'string' || explicitProp) {
+            forEachOperation(api, (op, method, path) => {
+                if (op['x-mcp-emit'] === 'skip' || op['x-mcp-jq-filter'])
+                    return;
+                const key = `${method.toUpperCase()} ${path}`;
+                if (explicitProp) {
+                    op['x-mcp-jq-filter'] = `.${explicitProp}`;
+                    unwrapped.push(key);
+                }
+                else {
+                    // Boolean `true`: only unwrap when the success schema actually has a
+                    // `data` envelope, so non-enveloped responses are left untouched.
+                    const schema = successSchema(op);
+                    if (schema && hasProperty(schema, 'data')) {
+                        op['x-mcp-jq-filter'] = '.data';
+                        unwrapped.push(key);
+                    }
+                }
+            });
+        }
+    }
+    // 3. Named environments → base URL + MCP_ENVIRONMENTS seed.
+    let environments;
+    let defaultEnvironment;
+    let baseUrl;
+    if (config.environments && typeof config.environments === 'object') {
+        const entries = Object.entries(config.environments).filter(([, v]) => typeof v === 'string' && v);
+        if (entries.length > 0) {
+            environments = Object.fromEntries(entries);
+            defaultEnvironment = 'production' in environments ? 'production' : entries[0][0];
+            baseUrl = environments[defaultEnvironment];
+            report.push(`Environments: ${entries.map(([n]) => n).join(', ')} (default "${defaultEnvironment}" → ${baseUrl}).`);
+        }
+    }
+    // 4. Auth: pick a security scheme and/or rename its env var (read_env).
+    const authOverride = deriveAuthOverride(config);
+    if (authOverride) {
+        if (authOverride.schemeName) {
+            report.push(`Auth: pinned to security scheme "${authOverride.schemeName}".`);
+        }
+        if (authOverride.envVarName) {
+            report.push(`Auth: credential read from env var "${authOverride.envVarName}" (read_env).`);
+        }
+    }
+    // 5. Code-mode detection (Stainless's current 2-tool default).
+    const mcp = resolveMcpServer(config);
+    const codeMode = !!(mcp &&
+        (mcp.code === true ||
+            mcp.code_execution === true ||
+            mcp.tools === 'code' ||
+            (Array.isArray(mcp.tools) && mcp.tools.includes('code'))));
+    const docsSearch = !!(mcp && mcp.docs_search === true);
+    if (codeMode) {
+        warnings.push('Stainless code-mode MCP server detected (a sandboxed code-execution tool + docs-search). ' +
+            'mcpmake has no sandbox/code-exec equivalent — generating OWNED, editable per-endpoint ' +
+            'tools instead. For large APIs add --dynamic-discovery (search_tools + on-demand schemas) ' +
+            'as the token-efficiency analog.');
+    }
+    if (Object.keys(toolNames).length > 0) {
+        report.push(`Tool names: derived ${Object.keys(toolNames).length} name(s) from the resource tree.`);
+    }
+    if (unwrapped.length > 0) {
+        report.push(`Response unwrap: applied a jq filter to ${unwrapped.length} operation(s).`);
+    }
+    if (skipped.length > 0) {
+        report.push(`Excluded ${skipped.length} operation(s) marked non-MCP in the Stainless config.`);
+    }
+    return {
+        toolNames,
+        environments,
+        defaultEnvironment,
+        baseUrl,
+        authOverride,
+        unwrapped,
+        skipped,
+        codeMode,
+        docsSearch,
+        warnings,
+        report,
+    };
+}
+// ---------------------------------------------------------------------------
+// Resource tree
+// ---------------------------------------------------------------------------
+function walkResources(resources, chain, visit) {
+    for (const [resourceName, resource] of Object.entries(resources)) {
+        if (!resource || typeof resource !== 'object')
+            continue;
+        const here = [...chain, resourceName];
+        if (resource.methods && typeof resource.methods === 'object') {
+            for (const [methodName, value] of Object.entries(resource.methods)) {
+                visit(methodName, value, here);
+            }
+        }
+        if (resource.subresources && typeof resource.subresources === 'object') {
+            walkResources(resource.subresources, here, visit);
+        }
+    }
+}
+function parseMethodPointer(value) {
+    if (typeof value === 'string') {
+        const parts = value.trim().split(/\s+/);
+        if (parts.length >= 2 && HTTP_METHODS.has(parts[0].toLowerCase())) {
+            return { method: parts[0].toLowerCase(), path: parts.slice(1).join(' ') };
+        }
+        return { operationId: value.trim() };
+    }
+    if (value && typeof value === 'object') {
+        if (typeof value.endpoint === 'string') {
+            const parts = value.endpoint.trim().split(/\s+/);
+            if (parts.length >= 2 && HTTP_METHODS.has(parts[0].toLowerCase())) {
+                return { method: parts[0].toLowerCase(), path: parts.slice(1).join(' ') };
+            }
+        }
+        return {
+            method: typeof value.method === 'string' ? value.method.toLowerCase() : undefined,
+            path: typeof value.path === 'string' ? value.path : undefined,
+            operationId: (typeof value.operationId === 'string' && value.operationId) ||
+                (typeof value.operation_id === 'string' && value.operation_id) ||
+                undefined,
+        };
+    }
+    return {};
+}
+function locateOperation(api, ptr) {
+    if (ptr.method && ptr.path) {
+        const op = getOperation(api, ptr.method, ptr.path);
+        if (op)
+            return op;
+    }
+    if (ptr.operationId) {
+        return getOperationById(api, ptr.operationId);
+    }
+    return undefined;
+}
+function getOperation(api, method, path) {
+    const pathItem = api.paths?.[path];
+    if (!pathItem || typeof pathItem !== 'object')
+        return undefined;
+    const op = pathItem[method];
+    return op && typeof op === 'object' ? op : undefined;
+}
+function getOperationById(api, operationId) {
+    let found;
+    forEachOperation(api, (op) => {
+        if (!found && op.operationId === operationId)
+            found = op;
+    });
+    return found;
+}
+function forEachOperation(api, visit) {
+    for (const [path, pathItem] of Object.entries(api.paths ?? {})) {
+        if (!pathItem || typeof pathItem !== 'object')
+            continue;
+        for (const method of HTTP_METHODS) {
+            const op = pathItem[method];
+            if (op && typeof op === 'object')
+                visit(op, method, path);
+        }
+    }
+}
+function opKey(op) {
+    const id = typeof op.operationId === 'string' ? op.operationId : 'op';
+    return id;
+}
+function isMethodSkipped(value) {
+    if (value && typeof value === 'object') {
+        if (value.skip === true)
+            return true;
+        if (value.mcp === false)
+            return true;
+        if (value.mcp && typeof value.mcp === 'object' && value.mcp.enabled === false)
+            return true;
+    }
+    return false;
+}
+function isStainlessSkipped(op) {
+    if (op['x-stainless-skip'] === true)
+        return true;
+    if (op['x-stainless-mcp'] === false)
+        return true;
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Naming
+// ---------------------------------------------------------------------------
+/**
+ * Reproduce Stainless's resource-tree tool naming: the SDK call
+ * `<resource>.<method>` becomes the tool `<method>_<singular resource chain>`,
+ * child-first — e.g. `cards.issuing.create` → `create_issuing_card`.
+ */
+export function toolNameFromTree(methodName, chain) {
+    const method = methodName === 'del' ? 'delete' : methodName;
+    const tail = chain.slice().reverse().map(singularize).map(toSnake).filter(Boolean);
+    const head = toSnake(method);
+    return [head, ...tail].filter(Boolean).join('_');
+}
+export function singularize(word) {
+    if (/ies$/i.test(word))
+        return word.replace(/ies$/i, 'y');
+    if (/(ss|us|is)$/i.test(word))
+        return word; // status, focus, analysis — leave alone
+    if (/(s|x|z|ch|sh)es$/i.test(word))
+        return word.replace(/es$/i, '');
+    if (/s$/i.test(word))
+        return word.replace(/s$/i, '');
+    return word;
+}
+function toSnake(word) {
+    return word
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/[\s./-]+/g, '_')
+        .replace(/[^a-zA-Z0-9_]/g, '_')
+        .replace(/_+/g, '_')
+        .replace(/^_|_$/g, '')
+        .toLowerCase();
+}
+// ---------------------------------------------------------------------------
+// Responses / auth / mcp
+// ---------------------------------------------------------------------------
+function successSchema(op) {
+    const responses = op.responses;
+    if (!responses)
+        return undefined;
+    const response = (responses['200'] ?? responses['201']);
+    const content = response?.content;
+    const media = content?.['application/json'];
+    const schema = media?.schema;
+    return schema && typeof schema === 'object' ? schema : undefined;
+}
+function hasProperty(schema, prop) {
+    const props = schema.properties;
+    if (props && typeof props === 'object' && prop in props)
+        return true;
+    // Dereferenced specs (e.g. Stripe-style list envelopes) often compose the
+    // envelope as `allOf`/`oneOf`/`anyOf` rather than a flat `properties`.
+    for (const key of ['allOf', 'oneOf', 'anyOf']) {
+        const members = schema[key];
+        if (Array.isArray(members) &&
+            members.some((m) => m && typeof m === 'object' && hasProperty(m, prop))) {
+            return true;
+        }
+    }
+    return false;
+}
+function deriveAuthOverride(config) {
+    const opts = config.client_settings?.opts;
+    if (!opts || typeof opts !== 'object')
+        return undefined;
+    for (const opt of Object.values(opts)) {
+        if (!opt || typeof opt !== 'object')
+            continue;
+        const schemeName = opt.auth && typeof opt.auth === 'object' && typeof opt.auth.security_scheme === 'string'
+            ? opt.auth.security_scheme
+            : undefined;
+        const envVarName = typeof opt.read_env === 'string' ? sanitizeEnvVarName(opt.read_env) : undefined;
+        if (schemeName || envVarName)
+            return { schemeName, envVarName };
+    }
+    return undefined;
+}
+/**
+ * Coerce a Stainless `read_env` value into a valid POSIX-style env-var name so
+ * it is safe to emit as `process.env.<name>` / `os.environ.get("<name>")` in the
+ * generated code. (Real read_env values already look like `ACME_API_KEY`; this
+ * just guarantees an odd one can't produce invalid source.) Returns undefined
+ * when nothing usable remains.
+ */
+export function sanitizeEnvVarName(raw) {
+    let name = raw.trim().replace(/[^A-Za-z0-9_]/g, '_');
+    if (name && /^[0-9]/.test(name))
+        name = `_${name}`;
+    return name.length > 0 ? name : undefined;
+}
+function resolveMcpServer(config) {
+    if (config.mcp_server && typeof config.mcp_server === 'object') {
+        return config.mcp_server;
+    }
+    const targets = config.targets;
+    if (targets && typeof targets === 'object') {
+        const candidate = targets.mcp_server ?? targets.mcp;
+        if (candidate && typeof candidate === 'object')
+            return candidate;
+    }
+    return undefined;
+}
+//# sourceMappingURL=stainless-translator.js.map

package/dist/transformer/stainless-translator.js.map

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

package/dist/transformer/tool-builder.d.ts

@@ -0,0 +1,4 @@
+import type { OperationDescriptor, ToolDefinition } from '../types/index.js';
+export declare function buildToolDefinition(op: OperationDescriptor): ToolDefinition;
+export declare function buildAllTools(operations: OperationDescriptor[]): ToolDefinition[];
+//# sourceMappingURL=tool-builder.d.ts.map

package/dist/transformer/tool-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-builder.d.ts","sourceRoot":"","sources":["../../src/transformer/tool-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AAczF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,mBAAmB,GAAG,cAAc,CA6D3E;AAkDD,wBAAgB,aAAa,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,cAAc,EAAE,CA2BjF"}

package/dist/transformer/tool-builder.js

@@ -0,0 +1,119 @@
+import { buildOperationInputSchema, jsonSchemaToOutputZodCode, } from '../parser/schema-converter.js';
+import { toToolName, toToolTitle, toFileName, toFunctionName } from './naming.js';
+import { escapeTemplateLiteral, escapeStringLiteral, sanitizeIdentifier, sanitizePathTemplate, } from '../utils/sanitize.js';
+export function buildToolDefinition(op) {
+    const inputSchemaCode = buildOperationInputSchema(op);
+    const descParts = [];
+    if (op.summary)
+        descParts.push(op.summary);
+    if (op.description && op.description !== op.summary)
+        descParts.push(op.description);
+    if (op.deprecated)
+        descParts.push('[DEPRECATED]');
+    if (op.mcpExtensions?.deprecationMessage) {
+        descParts.push(`[DEPRECATED: ${op.mcpExtensions.deprecationMessage}]`);
+    }
+    if (op.mcpExtensions?.deprecationReplacement) {
+        descParts.push(`Use ${op.mcpExtensions.deprecationReplacement} instead.`);
+    }
+    const description = escapeTemplateLiteral(descParts.join(' — ') || `${op.method.toUpperCase()} ${op.path}`);
+    const pathParams = op.parameters.filter((p) => p.in === 'path').map((p) => p.name);
+    const queryParams = op.parameters.filter((p) => p.in === 'query').map((p) => p.name);
+    // Apply x-mcp-* extension overrides
+    const mcpName = op.mcpExtensions?.name;
+    const mcpDesc = op.mcpExtensions?.description;
+    // Output schema from 200 response
+    const successResponse = op.responses.find((r) => r.statusCode === '200' || r.statusCode === '201');
+    const outputSchemaCode = successResponse?.schema
+        ? jsonSchemaToOutputZodCode(successResponse.schema)
+        : undefined;
+    // Annotations from HTTP method semantics
+    const annotations = buildAnnotations(op.method);
+    return {
+        name: mcpName ? sanitizeIdentifier(mcpName) : toToolName(op.operationId),
+        title: mcpName ? mcpName : toToolTitle(op.operationId),
+        description: mcpDesc ? escapeTemplateLiteral(mcpDesc) : description,
+        inputSchemaCode,
+        outputSchemaCode,
+        operationId: op.operationId,
+        method: op.method,
+        pathTemplate: op.path,
+        pathParams,
+        queryParams,
+        headerParams: op.parameters.filter((p) => p.in === 'header').map((p) => p.name),
+        hasRequestBody: !!op.requestBody,
+        requestBodyContentType: op.requestBody?.contentType ?? 'application/json',
+        fileName: toFileName(op.operationId),
+        functionName: toFunctionName(op.operationId),
+        buildUrlBody: generateBuildUrlBody(op.path, pathParams, queryParams),
+        annotations,
+        isAsync: op.responses.some((r) => r.statusCode === '202'),
+        isDestructive: op.method === 'delete',
+        // Escaped because it is emitted into a single-quoted string literal
+        // (`applyJqFilter(result, '<jqFilter>')`) in the tool-handler template.
+        jqFilter: op.mcpExtensions?.jqFilter
+            ? escapeStringLiteral(op.mcpExtensions.jqFilter)
+            : undefined,
+    };
+}
+function buildAnnotations(method) {
+    switch (method) {
+        case 'get':
+        case 'head':
+        case 'options':
+            return { readOnlyHint: true };
+        case 'delete':
+            return { destructiveHint: true };
+        case 'put':
+            return { idempotentHint: true };
+        default:
+            return undefined;
+    }
+}
+function generateBuildUrlBody(pathTemplate, pathParams, queryParams) {
+    const safePath = sanitizePathTemplate(pathTemplate);
+    const lines = [];
+    lines.push(`  let url = baseUrl + '${escapeStringLiteral(safePath)}';`);
+    for (const p of pathParams) {
+        const safeP = sanitizeIdentifier(p);
+        lines.push(`  url = url.replace('${escapeStringLiteral(`{${safeP}}`)}', encodeURIComponent(String(params['${escapeStringLiteral(safeP)}'])));`);
+    }
+    if (queryParams.length > 0) {
+        lines.push('  const query = new URLSearchParams();');
+        for (const q of queryParams) {
+            const safeQ = sanitizeIdentifier(q);
+            lines.push(`  if (params['${escapeStringLiteral(safeQ)}'] !== undefined) query.set('${escapeStringLiteral(safeQ)}', String(params['${escapeStringLiteral(safeQ)}']));`);
+        }
+        lines.push('  const qs = query.toString();');
+        lines.push('  return qs ? `${url}?${qs}` : url;');
+    }
+    else {
+        lines.push('  return url;');
+    }
+    return lines.join('\n');
+}
+export function buildAllTools(operations) {
+    // Filter out operations marked with x-mcp-emit: skip
+    const filtered = operations.filter((op) => op.mcpExtensions?.emit !== 'skip');
+    const tools = filtered.map(buildToolDefinition);
+    // Handle name collisions by appending method
+    const nameCount = new Map();
+    for (const t of tools) {
+        nameCount.set(t.name, (nameCount.get(t.name) ?? 0) + 1);
+    }
+    for (const tool of tools) {
+        if ((nameCount.get(tool.name) ?? 0) > 1) {
+            tool.name = `${tool.name}_${tool.method}`;
+            tool.fileName = `${tool.fileName}-${tool.method}`;
+            tool.functionName = `${tool.functionName}${tool.method.charAt(0).toUpperCase() + tool.method.slice(1)}`;
+        }
+    }
+    // Enforce MCP spec name length limit (128 chars)
+    for (const tool of tools) {
+        if (tool.name.length > 128) {
+            tool.name = tool.name.slice(0, 128);
+        }
+    }
+    return tools;
+}
+//# sourceMappingURL=tool-builder.js.map

package/dist/transformer/tool-builder.js.map

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