@markstiles/sitecore-search-mcp 1.0.0

package/dist/utils/auth-manager.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Authentication scopes for Sitecore Search APIs
+ */
+export type AuthScope = 'discover' | 'event' | 'ingestion';
+/**
+ * Authentication Manager for Sitecore Search APIs
+ * Handles API key authentication and token management (generation, refresh, expiry)
+ */
+export declare class AuthManager {
+    private apiKey?;
+    private scopes;
+    private accessTokenExpiry;
+    private refreshTokenExpiry;
+    private logger;
+    private authEndpoint;
+    private axios;
+    private tokenStorage?;
+    private tokenRefreshPromise?;
+    constructor(apiKey?: string | undefined, scopes?: AuthScope[], accessTokenExpiry?: number, // 1 day default
+    refreshTokenExpiry?: number);
+    /**
+     * Get authentication header for API requests
+     * Returns either API key or access token in Authorization header
+     */
+    getAuthHeader(): Promise<Record<string, string>>;
+    /**
+     * Get a valid access token (generates new one if needed or refreshes if expired)
+     */
+    private getAccessToken;
+    /**
+     * Generate access and refresh tokens from API key
+     */
+    private generateTokensFromApiKey;
+    /**
+     * Refresh access token using refresh token
+     */
+    private refreshAccessToken;
+    /**
+     * Check if access token is valid (not expired)
+     * Returns true if valid, false if expired or about to expire (within 1 minute)
+     */
+    private isAccessTokenValid;
+    /**
+     * Check if refresh token is valid (not expired)
+     */
+    private isRefreshTokenValid;
+    /**
+     * Force clear stored tokens (useful for testing or manual token invalidation)
+     */
+    clearTokens(): void;
+    /**
+     * Get current token status for debugging
+     */
+    getTokenStatus(): {
+        hasTokens: boolean;
+        accessTokenValid: boolean;
+        refreshTokenValid: boolean;
+    };
+}
+//# sourceMappingURL=auth-manager.d.ts.map

package/dist/utils/auth-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../src/utils/auth-manager.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AA6B3D;;;GAGG;AACH,qBAAa,WAAW;IAQpB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,kBAAkB;IAV5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAmD;IACvE,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,mBAAmB,CAAC,CAAkB;gBAGpC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,MAAM,GAAE,SAAS,EAAuC,EACxD,iBAAiB,GAAE,MAAiB,EAAE,gBAAgB;IACtD,kBAAkB,GAAE,MAAkB;IAWhD;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IA2BtD;;OAEG;YACW,cAAc;IA4B5B;;OAEG;YACW,wBAAwB;IAsCtC;;OAEG;YACW,kBAAkB;IAgChC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,cAAc,IAAI;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,iBAAiB,EAAE,OAAO,CAAC;KAC5B;CAOF"}

package/dist/utils/auth-manager.js

@@ -0,0 +1,184 @@
+import axios from 'axios';
+import { Logger } from './logger.js';
+/**
+ * Authentication Manager for Sitecore Search APIs
+ * Handles API key authentication and token management (generation, refresh, expiry)
+ */
+export class AuthManager {
+    apiKey;
+    scopes;
+    accessTokenExpiry;
+    refreshTokenExpiry;
+    logger;
+    authEndpoint = 'https://api.rfksrv.com/account/1/access-token';
+    axios;
+    tokenStorage;
+    tokenRefreshPromise;
+    constructor(apiKey, scopes = ['discover', 'event', 'ingestion'], accessTokenExpiry = 86400000, // 1 day default
+    refreshTokenExpiry = 604800000 // 7 days default
+    ) {
+        this.apiKey = apiKey;
+        this.scopes = scopes;
+        this.accessTokenExpiry = accessTokenExpiry;
+        this.refreshTokenExpiry = refreshTokenExpiry;
+        this.logger = new Logger('AuthManager');
+        this.axios = axios.create({
+            timeout: 10000,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+    /**
+     * Get authentication header for API requests
+     * Returns either API key or access token in Authorization header
+     */
+    async getAuthHeader() {
+        // If no API key configured, return empty headers (subdomain authentication)
+        if (!this.apiKey) {
+            return {};
+        }
+        // For Ingestion API, always use API key (per documentation)
+        if (this.scopes.includes('ingestion') && this.scopes.length === 1) {
+            return {
+                Authorization: this.apiKey,
+            };
+        }
+        // Try to use access token for other APIs
+        const accessToken = await this.getAccessToken();
+        if (accessToken) {
+            return {
+                Authorization: `Bearer ${accessToken}`,
+            };
+        }
+        // Fallback to API key
+        return {
+            Authorization: this.apiKey,
+        };
+    }
+    /**
+     * Get a valid access token (generates new one if needed or refreshes if expired)
+     */
+    async getAccessToken() {
+        // If we're already refreshing, wait for that operation
+        if (this.tokenRefreshPromise) {
+            return this.tokenRefreshPromise;
+        }
+        // Check if we have a valid access token
+        if (this.tokenStorage && this.isAccessTokenValid()) {
+            return this.tokenStorage.accessToken;
+        }
+        // Check if we have a valid refresh token
+        if (this.tokenStorage && this.isRefreshTokenValid()) {
+            this.tokenRefreshPromise = this.refreshAccessToken()
+                .finally(() => {
+                this.tokenRefreshPromise = undefined;
+            });
+            return this.tokenRefreshPromise;
+        }
+        // Generate new tokens from API key
+        this.tokenRefreshPromise = this.generateTokensFromApiKey()
+            .finally(() => {
+            this.tokenRefreshPromise = undefined;
+        });
+        return this.tokenRefreshPromise;
+    }
+    /**
+     * Generate access and refresh tokens from API key
+     */
+    async generateTokensFromApiKey() {
+        if (!this.apiKey) {
+            throw new Error('API key is required to generate tokens');
+        }
+        this.logger.debug('Generating new access token from API key');
+        try {
+            const response = await this.axios.post(this.authEndpoint, {
+                scope: this.scopes,
+                accessExpiry: this.accessTokenExpiry,
+                refreshExpiry: this.refreshTokenExpiry,
+            }, {
+                headers: {
+                    'x-api-key': this.apiKey,
+                },
+            });
+            const now = Date.now();
+            this.tokenStorage = {
+                accessToken: response.data.accessToken,
+                refreshToken: response.data.refreshToken,
+                accessTokenExpiresAt: now + response.data.accessTokenExpiry,
+                refreshTokenExpiresAt: now + response.data.refreshTokenExpiry,
+            };
+            this.logger.info('Successfully generated new access token');
+            return this.tokenStorage.accessToken;
+        }
+        catch (error) {
+            this.logger.error('Failed to generate access token from API key', error);
+            throw error;
+        }
+    }
+    /**
+     * Refresh access token using refresh token
+     */
+    async refreshAccessToken() {
+        if (!this.tokenStorage) {
+            throw new Error('No token storage available for refresh');
+        }
+        this.logger.debug('Refreshing access token using refresh token');
+        try {
+            const response = await this.axios.put(this.authEndpoint, {}, {
+                headers: {
+                    Authorization: `Bearer ${this.tokenStorage.refreshToken}`,
+                },
+            });
+            // Update only the access token, keep the refresh token
+            this.tokenStorage.accessToken = response.data.accessToken;
+            this.tokenStorage.accessTokenExpiresAt = Date.now() + this.accessTokenExpiry;
+            this.logger.info('Successfully refreshed access token');
+            return this.tokenStorage.accessToken;
+        }
+        catch (error) {
+            this.logger.error('Failed to refresh access token', error);
+            // Clear token storage to force re-authentication
+            this.tokenStorage = undefined;
+            throw error;
+        }
+    }
+    /**
+     * Check if access token is valid (not expired)
+     * Returns true if valid, false if expired or about to expire (within 1 minute)
+     */
+    isAccessTokenValid() {
+        if (!this.tokenStorage) {
+            return false;
+        }
+        // Add 1 minute buffer before expiry
+        return Date.now() < this.tokenStorage.accessTokenExpiresAt - 60000;
+    }
+    /**
+     * Check if refresh token is valid (not expired)
+     */
+    isRefreshTokenValid() {
+        if (!this.tokenStorage) {
+            return false;
+        }
+        return Date.now() < this.tokenStorage.refreshTokenExpiresAt;
+    }
+    /**
+     * Force clear stored tokens (useful for testing or manual token invalidation)
+     */
+    clearTokens() {
+        this.tokenStorage = undefined;
+        this.logger.info('Cleared stored tokens');
+    }
+    /**
+     * Get current token status for debugging
+     */
+    getTokenStatus() {
+        return {
+            hasTokens: !!this.tokenStorage,
+            accessTokenValid: this.isAccessTokenValid(),
+            refreshTokenValid: this.isRefreshTokenValid(),
+        };
+    }
+}
+//# sourceMappingURL=auth-manager.js.map

package/dist/utils/auth-manager.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+/**
+ * Base error class for Sitecore API errors
+ */
+export declare class SitecoreApiError extends Error {
+    statusCode?: number | undefined;
+    response?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: unknown | undefined);
+}
+/**
+ * Error handling utility for API responses
+ */
+export declare function handleApiError(error: unknown): never;
+/**
+ * Validate input against a Zod schema
+ */
+export declare function validateInput<T>(schema: z.ZodSchema<T>, input: unknown): T;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAGhC,UAAU,CAAC,EAAE,MAAM;IACnB,QAAQ,CAAC,EAAE,OAAO;gBAFzB,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,QAAQ,CAAC,EAAE,OAAO,YAAA;CAK5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CA6BpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAY1E"}

package/dist/utils/errors.js

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+/**
+ * Base error class for Sitecore API errors
+ */
+export class SitecoreApiError extends Error {
+    statusCode;
+    response;
+    constructor(message, statusCode, response) {
+        super(message);
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = 'SitecoreApiError';
+    }
+}
+/**
+ * Error handling utility for API responses
+ */
+export function handleApiError(error) {
+    if (error instanceof SitecoreApiError) {
+        throw error;
+    }
+    if (typeof error === 'object' && error !== null) {
+        const err = error;
+        if (err.response) {
+            // Axios error with response
+            const statusCode = err.response.status;
+            const data = err.response.data;
+            let message = `API request failed with status ${statusCode}`;
+            if (data?.message) {
+                message = data.message;
+            }
+            else if (typeof data === 'string') {
+                message = data;
+            }
+            throw new SitecoreApiError(message, statusCode, data);
+        }
+        if (err.message) {
+            throw new SitecoreApiError(err.message);
+        }
+    }
+    throw new SitecoreApiError('Unknown error occurred');
+}
+/**
+ * Validate input against a Zod schema
+ */
+export function validateInput(schema, input) {
+    try {
+        return schema.parse(input);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const formattedErrors = error.errors.map(err => `${err.path.join('.')}: ${err.message}`).join(', ');
+            throw new Error(`Validation error: ${formattedErrors}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGhC;IACA;IAHT,YACE,OAAe,EACR,UAAmB,EACnB,QAAkB;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAS;QACnB,aAAQ,GAAR,QAAQ,CAAU;QAGzB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;QACtC,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,KAAY,CAAC;QAEzB,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,4BAA4B;YAC5B,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YAE/B,IAAI,OAAO,GAAG,kCAAkC,UAAU,EAAE,CAAC;YAC7D,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC;gBAClB,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YACzB,CAAC;iBAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YAED,MAAM,IAAI,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,MAAM,IAAI,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,MAAsB,EAAE,KAAc;IACrE,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAC7C,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,eAAe,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Logger utility for structured logging
+ */
+export declare class Logger {
+    private context;
+    constructor(context: string);
+    info(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, error?: Error, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAEnC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAU3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAY3E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAU3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAW7D"}

package/dist/utils/logger.js

@@ -0,0 +1,50 @@
+/**
+ * Logger utility for structured logging
+ */
+export class Logger {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    info(message, meta) {
+        console.log(JSON.stringify({
+            level: 'info',
+            context: this.context,
+            message,
+            timestamp: new Date().toISOString(),
+            ...meta,
+        }));
+    }
+    error(message, error, meta) {
+        console.error(JSON.stringify({
+            level: 'error',
+            context: this.context,
+            message,
+            error: error?.message,
+            stack: error?.stack,
+            timestamp: new Date().toISOString(),
+            ...meta,
+        }));
+    }
+    warn(message, meta) {
+        console.warn(JSON.stringify({
+            level: 'warn',
+            context: this.context,
+            message,
+            timestamp: new Date().toISOString(),
+            ...meta,
+        }));
+    }
+    debug(message, meta) {
+        if (process.env.DEBUG) {
+            console.debug(JSON.stringify({
+                level: 'debug',
+                context: this.context,
+                message,
+                timestamp: new Date().toISOString(),
+                ...meta,
+            }));
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,MAAM;IACG;IAApB,YAAoB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEvC,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;YACzB,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,GAAG,IAAI;SACR,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAa,EAAE,IAA8B;QAClE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;YAC3B,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO;YACP,KAAK,EAAE,KAAK,EAAE,OAAO;YACrB,KAAK,EAAE,KAAK,EAAE,KAAK;YACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,GAAG,IAAI;SACR,CAAC,CAAC,CAAC;IACN,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;YAC1B,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,GAAG,IAAI;SACR,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC3B,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO;gBACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,IAAI;aACR,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;CACF"}

package/dist/utils/schema.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+/**
+ * Convert a Zod schema to JSON Schema format for MCP
+ */
+export declare function toJsonSchema(zodSchema: z.ZodType<any>): any;
+//# sourceMappingURL=schema.d.ts.map

package/dist/utils/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAUrD"}

package/dist/utils/schema.js

@@ -0,0 +1,14 @@
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Convert a Zod schema to JSON Schema format for MCP
+ */
+export function toJsonSchema(zodSchema) {
+    const jsonSchema = zodToJsonSchema(zodSchema, {
+        target: 'jsonSchema7',
+        $refStrategy: 'none'
+    });
+    // Remove $schema field as MCP doesn't expect it
+    const { $schema, ...rest } = jsonSchema;
+    return rest;
+}
+//# sourceMappingURL=schema.js.map

package/dist/utils/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAyB;IACpD,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,EAAE;QAC5C,MAAM,EAAE,aAAa;QACrB,YAAY,EAAE,MAAM;KACrB,CAAC,CAAC;IAEH,gDAAgD;IAChD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,UAAiB,CAAC;IAE/C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@markstiles/sitecore-search-mcp",
+  "version": "1.0.0",
+  "description": "Model Context Protocol server for Sitecore Search APIs (Search, Ingestion, and Events)",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-sitecore-search-server": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE",
+    "AUTHENTICATION.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "sitecore",
+    "sitecore-search",
+    "search",
+    "api",
+    "search-api",
+    "ingestion",
+    "events",
+    "analytics"
+  ],
+  "author": "Your Name <your.email@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/markstiles/mcp-sitecore-search-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/markstiles/mcp-sitecore-search-server/issues"
+  },
+  "homepage": "https://github.com/markstiles/mcp-sitecore-search-server#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.6.0",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}