@ampeco/public-api-mcp 0.2.0

package/dist/build/zod-generator.js

@@ -0,0 +1,317 @@
+/**
+ * Zod Schema Generation Module
+ *
+ * This module handles:
+ * - Converting OpenAPI schemas to Zod validation schemas
+ * - Supporting complex types, enums, unions, and validation rules
+ * - Enabling runtime type safety and parameter validation
+ */
+/**
+ * Generate Zod schema code from OpenAPI JSON schema
+ *
+ * @param schema - OpenAPI JSON schema
+ * @returns Zod schema as a string of TypeScript code
+ */
+export function generateZodSchema(schema) {
+    if (!schema) {
+        return "z.unknown()";
+    }
+    // Handle references (should be dereferenced already, but just in case)
+    if (schema.$ref) {
+        console.warn(`[ZodGen] Found unresolved reference: ${schema.$ref}`);
+        return "z.unknown()";
+    }
+    // Handle nullable
+    const nullable = schema.nullable === true;
+    let zodSchema = generateZodSchemaCore(schema);
+    // Add nullable wrapper if needed
+    if (nullable) {
+        zodSchema = `${zodSchema}.nullable()`;
+    }
+    return zodSchema;
+}
+/**
+ * Generate core Zod schema without nullable wrapper
+ *
+ * @param schema - OpenAPI JSON schema
+ * @returns Zod schema string
+ */
+function generateZodSchemaCore(schema) {
+    // Handle allOf (should be flattened already, but handle it)
+    if (schema.allOf) {
+        const schemas = schema.allOf.map((s) => generateZodSchemaCore(s));
+        return `z.intersection(${schemas.join(", ")})`;
+    }
+    // Handle anyOf
+    if (schema.anyOf) {
+        const schemas = schema.anyOf.map((s) => generateZodSchemaCore(s));
+        // Zod union requires at least 2 schemas
+        if (schemas.length === 1) {
+            return schemas[0];
+        }
+        return `z.union([${schemas.join(", ")}])`;
+    }
+    // Handle oneOf
+    if (schema.oneOf) {
+        const schemas = schema.oneOf.map((s) => generateZodSchemaCore(s));
+        // Zod union requires at least 2 schemas
+        if (schemas.length === 1) {
+            return schemas[0];
+        }
+        return `z.union([${schemas.join(", ")}])`;
+    }
+    // Handle enum
+    if (schema.enum) {
+        // Check if all enum values are strings
+        const allStrings = schema.enum.every((v) => typeof v === "string");
+        if (allStrings && schema.enum.length >= 1) {
+            const enumValues = schema.enum.map((v) => JSON.stringify(v)).join(", ");
+            return `z.enum([${enumValues}])`;
+        }
+        else {
+            // Fall back to union of literals for mixed types or non-string enums
+            const literalValues = schema.enum.map((v) => {
+                if (v === null)
+                    return "z.null()";
+                if (typeof v === "number")
+                    return `z.literal(${v})`;
+                return `z.literal(${JSON.stringify(v)})`;
+            }).join(", ");
+            if (schema.enum.length === 1) {
+                return literalValues;
+            }
+            return `z.union([${literalValues}])`;
+        }
+    }
+    // Handle type-specific schemas
+    switch (schema.type) {
+        case "string":
+            return generateStringSchema(schema);
+        case "number":
+        case "integer":
+            return generateNumberSchema(schema);
+        case "boolean":
+            return "z.boolean()";
+        case "array":
+            return generateArraySchema(schema);
+        case "object":
+            return generateObjectSchema(schema);
+        case "null":
+            return "z.null()";
+        default:
+            // No type specified, try to infer from other properties
+            if (schema.properties) {
+                return generateObjectSchema(schema);
+            }
+            if (schema.items) {
+                return generateArraySchema(schema);
+            }
+            return "z.unknown()";
+    }
+}
+/**
+ * Generate Zod string schema with validation
+ */
+function generateStringSchema(schema) {
+    let zodSchema = "z.string()";
+    // Add format validation
+    if (schema.format) {
+        switch (schema.format) {
+            case "email":
+                zodSchema += ".email()";
+                break;
+            case "uri":
+            case "url":
+                zodSchema += ".url()";
+                break;
+            case "uuid":
+                zodSchema += ".uuid()";
+                break;
+            case "date-time":
+                zodSchema += ".datetime()";
+                break;
+            // Note: Other formats like "date", "time" could be added with custom validation
+        }
+    }
+    // Add length validation
+    if (schema.minLength !== undefined) {
+        zodSchema += `.min(${schema.minLength})`;
+    }
+    if (schema.maxLength !== undefined) {
+        zodSchema += `.max(${schema.maxLength})`;
+    }
+    // Add pattern validation
+    if (schema.pattern) {
+        const escapedPattern = schema.pattern.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+        zodSchema += `.regex(new RegExp("${escapedPattern}"))`;
+    }
+    return zodSchema;
+}
+/**
+ * Generate Zod number schema with validation
+ */
+function generateNumberSchema(schema) {
+    let zodSchema = schema.type === "integer" ? "z.number().int()" : "z.number()";
+    // Add range validation
+    if (schema.minimum !== undefined) {
+        if (schema.exclusiveMinimum) {
+            zodSchema += `.gt(${schema.minimum})`;
+        }
+        else {
+            zodSchema += `.min(${schema.minimum})`;
+        }
+    }
+    if (schema.maximum !== undefined) {
+        if (schema.exclusiveMaximum) {
+            zodSchema += `.lt(${schema.maximum})`;
+        }
+        else {
+            zodSchema += `.max(${schema.maximum})`;
+        }
+    }
+    // Add multiple of validation
+    if (schema.multipleOf !== undefined) {
+        zodSchema += `.multipleOf(${schema.multipleOf})`;
+    }
+    return zodSchema;
+}
+/**
+ * Generate Zod array schema
+ */
+function generateArraySchema(schema) {
+    const itemsSchema = schema.items ? generateZodSchemaCore(schema.items) : "z.unknown()";
+    let zodSchema = `z.array(${itemsSchema})`;
+    // Add array length validation
+    if (schema.minItems !== undefined) {
+        zodSchema += `.min(${schema.minItems})`;
+    }
+    if (schema.maxItems !== undefined) {
+        zodSchema += `.max(${schema.maxItems})`;
+    }
+    return zodSchema;
+}
+/**
+ * Generate Zod object schema
+ */
+function generateObjectSchema(schema) {
+    if (!schema.properties || Object.keys(schema.properties).length === 0) {
+        // Empty object or additionalProperties only
+        if (schema.additionalProperties) {
+            if (schema.additionalProperties === true) {
+                return "z.record(z.unknown())";
+            }
+            else {
+                const valueSchema = generateZodSchemaCore(schema.additionalProperties);
+                return `z.record(${valueSchema})`;
+            }
+        }
+        return "z.object({})";
+    }
+    const properties = [];
+    const required = new Set(schema.required || []);
+    for (const [propName, propSchema] of Object.entries(schema.properties)) {
+        const isRequired = required.has(propName);
+        let propZodSchema = generateZodSchemaCore(propSchema);
+        // Make optional if not required
+        if (!isRequired) {
+            propZodSchema += ".optional()";
+        }
+        // Escape property name if needed
+        const safePropName = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(propName)
+            ? propName
+            : JSON.stringify(propName);
+        properties.push(`${safePropName}: ${propZodSchema}`);
+    }
+    let zodSchema = `z.object({\n  ${properties.join(",\n  ")}\n})`;
+    // Handle additionalProperties
+    if (schema.additionalProperties === false) {
+        zodSchema += ".strict()";
+    }
+    else if (schema.additionalProperties && schema.additionalProperties !== true) {
+        // passthrough() allows additional properties without validation
+        zodSchema += ".passthrough()";
+    }
+    return zodSchema;
+}
+/**
+ * Generate Zod schema for request parameters
+ *
+ * @param parameters - Array of parameter definitions
+ * @returns Object with Zod schemas for different parameter locations
+ */
+export function generateParameterSchemas(parameters) {
+    const byLocation = {
+        path: [],
+        query: [],
+        header: [],
+    };
+    // Group parameters by location
+    for (const param of parameters) {
+        if (param.in && byLocation[param.in]) {
+            byLocation[param.in].push(param);
+        }
+    }
+    const result = {};
+    // Generate schema for each location
+    for (const [location, params] of Object.entries(byLocation)) {
+        if (params.length === 0)
+            continue;
+        const properties = [];
+        const required = new Set(params.filter((p) => p.required).map((p) => p.name));
+        for (const param of params) {
+            const isRequired = required.has(param.name);
+            let paramSchema = param.schema ? generateZodSchemaCore(param.schema) : "z.string()";
+            if (!isRequired) {
+                paramSchema += ".optional()";
+            }
+            const safeName = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(param.name)
+                ? param.name
+                : JSON.stringify(param.name);
+            properties.push(`${safeName}: ${paramSchema}`);
+        }
+        result[location] = `z.object({\n  ${properties.join(",\n  ")}\n})`;
+    }
+    return result;
+}
+/**
+ * Generate complete Zod schemas file for all endpoints
+ *
+ * @param endpoints - Array of optimized endpoints
+ * @returns TypeScript code for Zod schemas
+ */
+export function generateZodSchemasFile(endpoints) {
+    const lines = [
+        'import { z } from "zod";',
+        "",
+        "// Auto-generated Zod schemas from OpenAPI specification",
+        "// Do not edit manually - regenerate with build script",
+        "",
+    ];
+    for (const endpoint of endpoints) {
+        const safeOperationId = endpoint.operationId
+            ?.replace(/[^a-zA-Z0-9]/g, "_")
+            .replace(/^(\d)/, "_$1") || `${endpoint.method}_${endpoint.path.replace(/[^a-zA-Z0-9]/g, "_")}`;
+        lines.push(`// ${endpoint.method} ${endpoint.path}`);
+        // Generate parameter schemas
+        if (endpoint.parameters && endpoint.parameters.length > 0) {
+            const paramSchemas = generateParameterSchemas(endpoint.parameters);
+            if (paramSchemas.path) {
+                lines.push(`export const ${safeOperationId}PathParams = ${paramSchemas.path};`);
+            }
+            if (paramSchemas.query) {
+                lines.push(`export const ${safeOperationId}QueryParams = ${paramSchemas.query};`);
+            }
+            if (paramSchemas.header) {
+                lines.push(`export const ${safeOperationId}HeaderParams = ${paramSchemas.header};`);
+            }
+        }
+        // Generate request body schema
+        if (endpoint.requestBody?.content?.["application/json"]?.schema) {
+            const bodySchema = generateZodSchema(endpoint.requestBody.content["application/json"].schema);
+            lines.push(`export const ${safeOperationId}Body = ${bodySchema};`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=zod-generator.js.map

package/dist/build/zod-generator.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point for MCP Server
+ * Supports both stdio and HTTP modes
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/cli/index.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point for MCP Server
+ * Supports both stdio and HTTP modes
+ */
+import { parseArgs } from 'node:util';
+import { startStdioServer } from '../server/stdio.js';
+import { startHttpServer } from '../server/http.js';
+function printHelp() {
+    console.log(`
+AMPECO Public API MCP Server
+
+Usage:
+  ampeco-api-mcp [options]
+
+Options:
+  --stdio              Run in stdio mode (for Claude Desktop, NPX)
+  --http               Run in HTTP mode (for remote access)
+  --hostname <url>     Target API hostname (required for stdio mode)
+  --token <token>      Bearer token for API authentication (stdio mode)
+  --port <port>        Port for HTTP server (default: 3000)
+  --help               Show this help message
+
+Examples:
+  Stdio mode (local):
+    ampeco-api-mcp --stdio --hostname http://demo.charge.alex2.dev.ampeco.tech --token $AMPECO_TOKEN
+
+  HTTP mode (remote):
+    ampeco-api-mcp --http --port 3001
+
+Environment Variables:
+  AMPECO_BEARER_TOKEN  Bearer token (alternative to --token)
+
+Notes:
+  - Stdio mode uses stderr for all logging to avoid interfering with MCP protocol
+  - For development, use 'npm run dev:stdio' which redirects build logs to stderr
+  - For production, run 'npm run build' first, then use the compiled CLI
+`);
+}
+async function main() {
+    const { values } = parseArgs({
+        options: {
+            stdio: { type: 'boolean', default: false },
+            http: { type: 'boolean', default: false },
+            port: { type: 'string', default: '3000' },
+            hostname: { type: 'string' },
+            token: { type: 'string' },
+            help: { type: 'boolean', default: false },
+        },
+        allowPositionals: false,
+    });
+    if (values.help) {
+        printHelp();
+        process.exit(0);
+    }
+    // Validate arguments
+    if (values.stdio && values.http) {
+        console.error('Error: Cannot specify both --stdio and --http');
+        console.error('\nUsage:');
+        console.error('  Stdio mode:  ampeco-api-mcp --stdio --hostname <hostname> [--token <token>]');
+        console.error('  HTTP mode:   ampeco-api-mcp --http [--port <port>]');
+        process.exit(1);
+    }
+    // Default to stdio if neither specified (for NPX compatibility)
+    const useStdio = values.stdio || !values.http;
+    if (useStdio) {
+        // Stdio mode: requires hostname and token
+        if (!values.hostname) {
+            console.error('Error: --hostname is required in stdio mode');
+            console.error('\nUsage:');
+            console.error('  ampeco-api-mcp --stdio --hostname <hostname> [--token <token>]');
+            console.error('\nExample:');
+            console.error('  ampeco-api-mcp --stdio --hostname http://demo.charge.alex2.dev.ampeco.tech --token $AMPECO_TOKEN');
+            console.error('\nNote: Token can also be provided via AMPECO_BEARER_TOKEN environment variable');
+            process.exit(1);
+        }
+        const token = values.token || process.env.AMPECO_BEARER_TOKEN || '';
+        if (!token) {
+            console.error('Warning: No bearer token provided. API requests may fail without authentication.');
+            console.error('Provide token via --token argument or AMPECO_BEARER_TOKEN environment variable.\n');
+        }
+        await startStdioServer(token, values.hostname);
+    }
+    else {
+        // HTTP mode: requires port
+        const port = parseInt(values.port || '3000', 10);
+        if (isNaN(port) || port < 1 || port > 65535) {
+            console.error(`Error: Invalid port number: ${values.port}`);
+            console.error('Port must be a number between 1 and 65535');
+            process.exit(1);
+        }
+        await startHttpServer(port);
+    }
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/generated/build-stats.json

@@ -0,0 +1,7 @@
+{
+  "totalEndpoints": 445,
+  "originalSize": 815026,
+  "optimizedSize": 537657,
+  "reductionPercent": 34.03,
+  "buildDuration": 584
+}