@eui/mcp 1.0.3

package/dist/config/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Configuration module exports
+ */
+export { Config, ConfigInput, ConfigSchema, DEFAULT_CONFIG, validateConfig, safeValidateConfig, } from './schema.js';
+export { ConfigLoadResult, loadConfig, loadFromEnv, loadFromArgs, loadFromFile, } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,MAAM,EACN,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,6 @@
+/**
+ * Configuration module exports
+ */
+export { ConfigSchema, DEFAULT_CONFIG, validateConfig, safeValidateConfig, } from './schema.js';
+export { loadConfig, loadFromEnv, loadFromArgs, loadFromFile, } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAGL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,27 @@
+import { Config, ConfigInput } from './schema.js';
+/**
+ * Configuration loading result
+ */
+export interface ConfigLoadResult {
+    success: boolean;
+    config?: Config;
+    errors?: string[];
+}
+/**
+ * Load configuration from environment variables
+ */
+export declare function loadFromEnv(): Partial<ConfigInput>;
+/**
+ * Load configuration from CLI arguments
+ */
+export declare function loadFromArgs(args: string[]): Partial<ConfigInput>;
+/**
+ * Load configuration from a JSON file
+ */
+export declare function loadFromFile(filePath: string): Partial<ConfigInput>;
+/**
+ * Load and merge configuration from all sources
+ * Priority: CLI args > Environment variables > Config file > Defaults
+ */
+export declare function loadConfig(args?: string[]): ConfigLoadResult;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAsC,MAAM,aAAa,CAAC;AAGtF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAuBlD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CA6CjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoBnE;AA+BD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,gBAAgB,CAsCnF"}

package/dist/config/loader.js

@@ -0,0 +1,224 @@
+/**
+ * Configuration loader
+ * Supports loading configuration from CLI args, environment variables, and config files
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { safeValidateConfig, DEFAULT_CONFIG } from './schema.js';
+/**
+ * Load configuration from environment variables
+ */
+export function loadFromEnv() {
+    const config = {};
+    if (process.env.COMPODOC_MCP_DOC_PATH) {
+        config.documentation = {
+            path: process.env.COMPODOC_MCP_DOC_PATH,
+        };
+    }
+    if (process.env.COMPODOC_MCP_LOG_LEVEL) {
+        config.logging = {
+            level: process.env.COMPODOC_MCP_LOG_LEVEL,
+        };
+    }
+    if (process.env.COMPODOC_MCP_WATCH !== undefined) {
+        if (!config.documentation) {
+            config.documentation = {};
+        }
+        config.documentation.watchForChanges = process.env.COMPODOC_MCP_WATCH === 'true';
+    }
+    return config;
+}
+/**
+ * Load configuration from CLI arguments
+ */
+export function loadFromArgs(args) {
+    const config = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--doc-path':
+            case '--documentation-path':
+                if (!config.documentation) {
+                    config.documentation = {};
+                }
+                config.documentation.path = args[++i];
+                break;
+            case '--watch':
+                if (!config.documentation) {
+                    config.documentation = {};
+                }
+                config.documentation.watchForChanges = true;
+                break;
+            case '--no-watch':
+                if (!config.documentation) {
+                    config.documentation = {};
+                }
+                config.documentation.watchForChanges = false;
+                break;
+            case '--log-level':
+                config.logging = {
+                    level: args[++i],
+                };
+                break;
+            case '--max-results':
+                config.search = {
+                    maxResults: parseInt(args[++i], 10),
+                };
+                break;
+            case '--help':
+            case '-h':
+                printHelp();
+                process.exit(0);
+                break;
+        }
+    }
+    return config;
+}
+/**
+ * Load configuration from a JSON file
+ */
+export function loadFromFile(filePath) {
+    try {
+        if (!fs.existsSync(filePath)) {
+            console.warn(`Configuration file not found: ${filePath}`);
+            return {};
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const ext = path.extname(filePath).toLowerCase();
+        if (ext === '.json') {
+            return JSON.parse(content);
+        }
+        console.warn(`Unsupported configuration file format: ${ext}`);
+        return {};
+    }
+    catch (error) {
+        console.error(`Failed to load config file ${filePath}:`, error);
+        return {};
+    }
+}
+/**
+ * Deep merge two objects
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key in source) {
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+            const sourceValue = source[key];
+            const targetValue = result[key];
+            if (sourceValue &&
+                typeof sourceValue === 'object' &&
+                !Array.isArray(sourceValue) &&
+                targetValue &&
+                typeof targetValue === 'object' &&
+                !Array.isArray(targetValue)) {
+                result[key] = deepMerge(targetValue, sourceValue);
+            }
+            else if (sourceValue !== undefined) {
+                result[key] = sourceValue;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Load and merge configuration from all sources
+ * Priority: CLI args > Environment variables > Config file > Defaults
+ */
+export function loadConfig(args = process.argv.slice(2)) {
+    try {
+        // Try to load from config file (if specified)
+        const configFileIndex = args.indexOf('--config');
+        const configFile = configFileIndex >= 0 ? args[configFileIndex + 1] : undefined;
+        const fileConfig = configFile ? loadFromFile(configFile) : {};
+        // Load from environment variables
+        const envConfig = loadFromEnv();
+        // Load from CLI arguments
+        const argsConfig = loadFromArgs(args);
+        // Start with defaults and merge in order of priority
+        let mergedConfig = { ...DEFAULT_CONFIG };
+        mergedConfig = deepMerge(mergedConfig, fileConfig);
+        mergedConfig = deepMerge(mergedConfig, envConfig);
+        mergedConfig = deepMerge(mergedConfig, argsConfig);
+        // Validate the merged configuration
+        const result = safeValidateConfig(mergedConfig);
+        if (!result.success) {
+            const errors = formatZodErrors(result.error);
+            console.error('Configuration validation failed:');
+            errors.forEach((error) => console.error(`  - ${error}`));
+            return { success: false, errors };
+        }
+        console.log('Configuration loaded successfully');
+        return { success: true, config: result.data };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            errors: [`Failed to load configuration: ${errorMessage}`],
+        };
+    }
+}
+/**
+ * Format Zod validation errors into readable messages
+ */
+function formatZodErrors(error) {
+    return error.errors.map((err) => {
+        const path = err.path.join('.');
+        return `${path}: ${err.message}`;
+    });
+}
+/**
+ * Print help message
+ */
+function printHelp() {
+    console.log(`
+EUI Compodoc MCP Server - Model Context Protocol server for Angular component documentation
+
+Usage:
+  eui-compodoc-mcp [options]
+
+Options:
+  --doc-path <path>              Path to documentation.json file (required)
+  --watch                        Watch for changes to documentation.json (default: true)
+  --no-watch                     Disable file watching
+  --log-level <level>            Logging level: debug, info, warn, error (default: info)
+  --max-results <number>         Maximum search results (default: 50)
+  --config <file>                Load configuration from JSON file
+  --help, -h                     Show this help message
+
+Environment Variables:
+  COMPODOC_MCP_DOC_PATH          Path to documentation.json file
+  COMPODOC_MCP_LOG_LEVEL         Logging level
+  COMPODOC_MCP_WATCH             Enable/disable file watching (true/false)
+
+Configuration File Format (JSON):
+  {
+    "server": {
+      "name": "eui-compodoc-mcp",
+      "version": "1.0.0"
+    },
+    "documentation": {
+      "path": "./documentation.json",
+      "watchForChanges": true,
+      "reloadDebounce": 1000
+    },
+    "search": {
+      "maxResults": 50,
+      "minQueryLength": 2
+    },
+    "logging": {
+      "level": "info",
+      "format": "text"
+    }
+  }
+
+Examples:
+  eui-compodoc-mcp --doc-path ./documentation.json
+  eui-compodoc-mcp --doc-path ./docs/documentation.json --log-level debug
+  eui-compodoc-mcp --config ./config.json
+  COMPODOC_MCP_DOC_PATH=./documentation.json eui-compodoc-mcp
+
+For more information, visit: https://github.com/your-org/eui-compodoc-mcp
+  `);
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Configuration schema and validation using Zod
+ */
+import { z } from 'zod';
+/**
+ * Complete configuration schema
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    server: z.ZodDefault<z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        version: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        version: string;
+        name: string;
+    }, {
+        version?: string | undefined;
+        name?: string | undefined;
+    }>>;
+    documentation: z.ZodObject<{
+        path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        watchForChanges: z.ZodDefault<z.ZodBoolean>;
+        reloadDebounce: z.ZodDefault<z.ZodNumber>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+        maxRetries: z.ZodDefault<z.ZodNumber>;
+        pollingInterval: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        watchForChanges: boolean;
+        reloadDebounce: number;
+        timeout: number;
+        maxRetries: number;
+        pollingInterval: number;
+    }, {
+        path: string;
+        watchForChanges?: boolean | undefined;
+        reloadDebounce?: number | undefined;
+        timeout?: number | undefined;
+        maxRetries?: number | undefined;
+        pollingInterval?: number | undefined;
+    }>;
+    search: z.ZodDefault<z.ZodObject<{
+        maxResults: z.ZodDefault<z.ZodNumber>;
+        minQueryLength: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxResults: number;
+        minQueryLength: number;
+    }, {
+        maxResults?: number | undefined;
+        minQueryLength?: number | undefined;
+    }>>;
+    logging: z.ZodDefault<z.ZodObject<{
+        level: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+        format: z.ZodDefault<z.ZodEnum<["json", "text"]>>;
+    }, "strip", z.ZodTypeAny, {
+        level: "error" | "debug" | "info" | "warn";
+        format: "text" | "json";
+    }, {
+        level?: "error" | "debug" | "info" | "warn" | undefined;
+        format?: "text" | "json" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    logging: {
+        level: "error" | "debug" | "info" | "warn";
+        format: "text" | "json";
+    };
+    server: {
+        version: string;
+        name: string;
+    };
+    documentation: {
+        path: string;
+        watchForChanges: boolean;
+        reloadDebounce: number;
+        timeout: number;
+        maxRetries: number;
+        pollingInterval: number;
+    };
+    search: {
+        maxResults: number;
+        minQueryLength: number;
+    };
+}, {
+    documentation: {
+        path: string;
+        watchForChanges?: boolean | undefined;
+        reloadDebounce?: number | undefined;
+        timeout?: number | undefined;
+        maxRetries?: number | undefined;
+        pollingInterval?: number | undefined;
+    };
+    logging?: {
+        level?: "error" | "debug" | "info" | "warn" | undefined;
+        format?: "text" | "json" | undefined;
+    } | undefined;
+    server?: {
+        version?: string | undefined;
+        name?: string | undefined;
+    } | undefined;
+    search?: {
+        maxResults?: number | undefined;
+        minQueryLength?: number | undefined;
+    } | undefined;
+}>;
+/**
+ * Inferred TypeScript type from schema
+ */
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Partial configuration input (before defaults are applied)
+ */
+export type ConfigInput = z.input<typeof ConfigSchema>;
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Partial<Config>;
+/**
+ * Validates and parses configuration input
+ * @param input - Raw configuration input
+ * @returns Validated configuration with defaults applied
+ * @throws ZodError if validation fails
+ */
+export declare function validateConfig(input: unknown): Config;
+/**
+ * Safely validates configuration and returns result with error details
+ * @param input - Raw configuration input
+ * @returns Validation result with success flag and data or errors
+ */
+export declare function safeValidateConfig(input: unknown): z.SafeParseReturnType<{
+    documentation: {
+        path: string;
+        watchForChanges?: boolean | undefined;
+        reloadDebounce?: number | undefined;
+        timeout?: number | undefined;
+        maxRetries?: number | undefined;
+        pollingInterval?: number | undefined;
+    };
+    logging?: {
+        level?: "error" | "debug" | "info" | "warn" | undefined;
+        format?: "text" | "json" | undefined;
+    } | undefined;
+    server?: {
+        version?: string | undefined;
+        name?: string | undefined;
+    } | undefined;
+    search?: {
+        maxResults?: number | undefined;
+        minQueryLength?: number | undefined;
+    } | undefined;
+}, {
+    logging: {
+        level: "error" | "debug" | "info" | "warn";
+        format: "text" | "json";
+    };
+    server: {
+        version: string;
+        name: string;
+    };
+    documentation: {
+        path: string;
+        watchForChanges: boolean;
+        reloadDebounce: number;
+        timeout: number;
+        maxRetries: number;
+        pollingInterval: number;
+    };
+    search: {
+        maxResults: number;
+        minQueryLength: number;
+    };
+}>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwDxB;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKvB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,MAAM,CAqB1C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEhD"}

package/dist/config/schema.js

@@ -0,0 +1,100 @@
+/**
+ * Configuration schema and validation using Zod
+ */
+import { z } from 'zod';
+import { PathTypeDetector } from '../loader/path-type-detector.js';
+/**
+ * Server configuration schema
+ */
+const ServerConfigSchema = z.object({
+    name: z.string().default('eui-compodoc-mcp'),
+    version: z.string().default('1.0.0'),
+});
+/**
+ * Documentation configuration schema
+ */
+const DocumentationConfigSchema = z.object({
+    path: z.string()
+        .min(1, 'Documentation path cannot be empty')
+        .refine((path) => path.trim().length > 0, { message: 'Documentation path cannot be only whitespace' })
+        .refine((path) => {
+        const trimmedPath = path.trim();
+        // If it looks like a URL (starts with http:// or https://), validate as URL
+        if (trimmedPath.startsWith('http://') || trimmedPath.startsWith('https://')) {
+            return PathTypeDetector.isRemoteUrl(trimmedPath);
+        }
+        // Otherwise, accept as local path
+        return true;
+    }, { message: 'Path must be a valid local file path or HTTP/HTTPS URL' }),
+    watchForChanges: z.boolean().default(true),
+    reloadDebounce: z.number().min(0).default(1000),
+    timeout: z.number().min(1000).default(10000),
+    maxRetries: z.number().min(0).max(10).default(3),
+    pollingInterval: z.number().min(5000).default(60000),
+});
+/**
+ * Search configuration schema
+ */
+const SearchConfigSchema = z.object({
+    maxResults: z.number().min(1).max(1000).default(50),
+    minQueryLength: z.number().min(1).default(2),
+});
+/**
+ * Logging configuration schema
+ */
+const LoggingConfigSchema = z.object({
+    level: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
+    format: z.enum(['json', 'text']).default('text'),
+});
+/**
+ * Complete configuration schema
+ */
+export const ConfigSchema = z.object({
+    server: ServerConfigSchema.default({}),
+    documentation: DocumentationConfigSchema,
+    search: SearchConfigSchema.default({}),
+    logging: LoggingConfigSchema.default({}),
+});
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    server: {
+        name: 'eui-compodoc-mcp',
+        version: '1.0.0',
+    },
+    documentation: {
+        path: './documentation.json',
+        watchForChanges: true,
+        reloadDebounce: 1000,
+        timeout: 10000,
+        maxRetries: 3,
+        pollingInterval: 60000,
+    },
+    search: {
+        maxResults: 50,
+        minQueryLength: 2,
+    },
+    logging: {
+        level: 'info',
+        format: 'text',
+    },
+};
+/**
+ * Validates and parses configuration input
+ * @param input - Raw configuration input
+ * @returns Validated configuration with defaults applied
+ * @throws ZodError if validation fails
+ */
+export function validateConfig(input) {
+    return ConfigSchema.parse(input);
+}
+/**
+ * Safely validates configuration and returns result with error details
+ * @param input - Raw configuration input
+ * @returns Validation result with success flag and data or errors
+ */
+export function safeValidateConfig(input) {
+    return ConfigSchema.safeParse(input);
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;CACrC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;SACb,GAAG,CAAC,CAAC,EAAE,oCAAoC,CAAC;SAC5C,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAChC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAC5D;SACA,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;QACP,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,4EAA4E;QAC5E,IAAI,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5E,OAAO,gBAAgB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QACnD,CAAC;QACD,kCAAkC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC,EACD,EAAE,OAAO,EAAE,wDAAwD,EAAE,CACtE;IACH,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC1C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CACrD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CAC7C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACjE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CACjD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,aAAa,EAAE,yBAAyB;IACxC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC;AAYH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,MAAM,EAAE;QACN,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO;KACjB;IACD,aAAa,EAAE;QACb,IAAI,EAAE,sBAAsB;QAC5B,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,CAAC;QACb,eAAe,EAAE,KAAK;KACvB;IACD,MAAM,EAAE;QACN,UAAU,EAAE,EAAE;QACd,cAAc,EAAE,CAAC;KAClB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,MAAM;KACf;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+const server = new Server({
+    name: "simple-mcp-server",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "echo",
+            description: "Echoes back the provided message",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    message: {
+                        type: "string",
+                        description: "Message to echo",
+                    },
+                },
+                required: ["message"],
+            },
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (request.params.name === "echo") {
+        const message = request.params.arguments?.message;
+        return {
+            content: [{ type: "text", text: `Echo: ${message}` }],
+        };
+    }
+    throw new Error(`Unknown tool: ${request.params.name}`);
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE;QACL;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,kCAAkC;YAC/C,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iBAAiB;qBAC/B;iBACF;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;aACtB;SACF;KACF;CACF,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAiB,CAAC;QAC5D,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,CAAC;SACtD,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,iBAAiB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}