swagger-parser-mcp-server 2.0.4 → 2.3.0

package/dist/index.js

@@ -1,23 +1,30 @@
 #!/usr/bin/env node
-// swagger-parser-server.ts
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-import { SwaggerCache } from './utils/swaggerCache.js';
-import { SchemaResolver } from './utils/schemaResolver.js';
-import { loadSwaggerSchema, getControllersSchema, getPathsByControllerSchema, getPathDetailsSchema, resolveSchemaSchema, } from './schemas.js';
+import { createSnapshotToolRuntime } from './transport/createSnapshotToolRuntime.js';
+import { startSnapshotWebServer } from './transport/webServerRuntime.js';
+export function attachStdioShutdownHooks(stdin, onClosed) {
+    let handled = false;
+    const handleClosed = () => {
+        if (handled) {
+            return;
+        }
+        handled = true;
+        onClosed();
+    };
+    stdin.once('end', handleClosed);
+    stdin.once('close', handleClosed);
+    return () => {
+        stdin.off('end', handleClosed);
+        stdin.off('close', handleClosed);
+    };
+}
 class SwaggerParserServer {
     server;
-    swaggerCache;
-    schemaResolver;
+    runtime = createSnapshotToolRuntime(process.env);
+    webServer = null;
     constructor() {
-        this.swaggerCache = new SwaggerCache();
-        this.schemaResolver = new SchemaResolver({
-            maxDepth: 10,
-            includeCircularRefs: false, // Prevent stack overflow by default
-            circularRefPlaceholder: '[Circular Reference]',
-        });
         this.server = new Server({
             name: 'swagger-parser-server',
             version: '1.0.0',
@@ -29,271 +36,86 @@ class SwaggerParserServer {
         this.setupHandlers();
     }
     setupHandlers() {
-        // 도구 목록 제공
         this.server.setRequestHandler(ListToolsRequestSchema, () => ({
-            tools: [
-                {
-                    name: 'load_swagger',
-                    description: 'Swagger/OpenAPI JSON URL을 로드합니다',
-                    inputSchema: zodToJsonSchema(loadSwaggerSchema),
-                },
-                {
-                    name: 'get_controllers',
-                    description: '모든 컨트롤러(태그) 목록을 가져옵니다',
-                    inputSchema: zodToJsonSchema(getControllersSchema),
-                },
-                {
-                    name: 'get_paths_by_controller',
-                    description: '특정 컨트롤러의 모든 path를 가져옵니다',
-                    inputSchema: zodToJsonSchema(getPathsByControllerSchema),
-                },
-                {
-                    name: 'get_path_details',
-                    description: '특정 path의 상세 정보를 가져옵니다',
-                    inputSchema: zodToJsonSchema(getPathDetailsSchema),
-                },
-                {
-                    name: 'resolve_schema',
-                    description: '$ref를 해결하여 실제 스키마를 가져옵니다',
-                    inputSchema: zodToJsonSchema(resolveSchemaSchema),
-                },
-            ],
+            tools: this.runtime.toolRouter.listTools(),
         }));
-        // 도구 실행 핸들러
         this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const { name, arguments: args } = request.params;
-            try {
-                switch (name) {
-                    case 'load_swagger': {
-                        const validatedArgs = loadSwaggerSchema.parse(args);
-                        return await this.loadSwagger(validatedArgs.url);
-                    }
-                    case 'get_controllers': {
-                        const validatedArgs = getControllersSchema.parse(args);
-                        return await this.getControllers(validatedArgs.url);
-                    }
-                    case 'get_paths_by_controller': {
-                        const validatedArgs = getPathsByControllerSchema.parse(args);
-                        return await this.getPathsByController(validatedArgs.url, validatedArgs.controller);
-                    }
-                    case 'get_path_details': {
-                        const validatedArgs = getPathDetailsSchema.parse(args);
-                        return await this.getPathDetails(validatedArgs.url, validatedArgs.path, validatedArgs.method);
-                    }
-                    case 'resolve_schema': {
-                        const validatedArgs = resolveSchemaSchema.parse(args);
-                        return await this.resolveSchema(validatedArgs.url, validatedArgs.ref);
-                    }
-                    default:
-                        throw new Error(`Unknown tool: ${name}`);
-                }
-            }
-            catch (error) {
-                const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Error: ${errorMessage}`,
-                        },
-                    ],
-                };
-            }
+            return this.runtime.toolRouter.execute(name, args);
         });
     }
-    async loadSwagger(url) {
-        try {
-            const swagger = await this.swaggerCache.load(url);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            info: swagger.info,
-                            pathCount: Object.keys(swagger.paths).length,
-                            hasComponents: !!swagger.components,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
-            throw new Error(`Failed to load Swagger: ${errorMessage}`);
+    async run(onTransportClosed) {
+        const transport = new StdioServerTransport();
+        if (onTransportClosed) {
+            transport.onclose = onTransportClosed;
         }
+        await this.server.connect(transport);
+        console.error('Swagger Parser MCP Server running on stdio');
     }
-    async getSwagger(url) {
-        return await this.swaggerCache.getOrLoad(url);
-    }
-    async getControllers(url) {
-        const swagger = await this.getSwagger(url);
-        const controllers = new Set();
-        Object.values(swagger.paths || {}).forEach(pathItem => {
-            if (!pathItem)
-                return;
-            // Check each HTTP method
-            const methods = ['get', 'post', 'put', 'delete', 'patch', 'head', 'options'];
-            methods.forEach(method => {
-                const operation = pathItem[method];
-                if (operation?.tags) {
-                    operation.tags.forEach((tag) => controllers.add(tag));
-                }
-            });
-        });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        controllers: Array.from(controllers),
-                        count: controllers.size,
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async getPathsByController(url, controller) {
-        const swagger = await this.getSwagger(url);
-        const paths = [];
-        Object.entries(swagger.paths || {}).forEach(([path, pathItem]) => {
-            if (!pathItem)
-                return;
-            // Check each HTTP method
-            const methods = ['get', 'post', 'put', 'delete', 'patch', 'head', 'options'];
-            methods.forEach(method => {
-                const operation = pathItem[method];
-                if (operation?.tags?.includes(controller)) {
-                    paths.push({
-                        path,
-                        method,
-                        operationId: operation.operationId,
-                        summary: operation.summary,
-                        description: operation.description,
-                    });
-                }
-            });
+    async startWebServer() {
+        this.webServer = await startSnapshotWebServer({
+            env: process.env,
+            toolRouter: this.runtime.toolRouter,
         });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        controller,
-                        paths,
-                        count: paths.length,
-                    }, null, 2),
-                },
-            ],
-        };
+        if (this.webServer.enabled) {
+            console.error(`Swagger Snapshot Web Server running on http://${this.webServer.host}:${this.webServer.port}`);
+            return;
+        }
+        console.error('Swagger Snapshot Web Server is disabled (SNAPSHOT_WEB_ENABLED=false)');
     }
-    async getPathDetails(url, path, method) {
-        const swagger = await this.getSwagger(url);
-        const pathItem = swagger.paths?.[path];
-        const operation = pathItem?.[method.toLowerCase()];
-        if (!operation || typeof operation !== 'object') {
-            throw new Error(`Path ${method.toUpperCase()} ${path} not found`);
+    async dispose() {
+        if (this.webServer) {
+            await this.webServer.close().catch(() => undefined);
+            this.webServer = null;
         }
-        // 파라미터 정보 추출
-        const parameters = operation.parameters?.map(param => {
-            // Handle $ref parameters by resolving them first
-            if ('$ref' in param) {
-                const resolvedParam = this.schemaResolver.resolveRef(param.$ref, swagger);
-                return {
-                    name: resolvedParam.name,
-                    in: resolvedParam.in,
-                    required: resolvedParam.required,
-                    description: resolvedParam.description,
-                    schema: this.schemaResolver.resolveSchemaReference(resolvedParam.schema, swagger),
-                };
-            }
-            return {
-                name: param.name,
-                in: param.in,
-                required: param.required,
-                description: param.description,
-                schema: this.schemaResolver.resolveSchemaReference(param.schema, swagger),
-            };
-        }) || [];
-        // Request Body 정보 추출
-        let requestBody = null;
-        if (operation.requestBody && 'content' in operation.requestBody && operation.requestBody.content) {
-            const content = operation.requestBody.content;
-            const mediaType = Object.keys(content)[0];
-            const mediaTypeObj = content[mediaType];
-            if (mediaTypeObj?.schema) {
-                requestBody = {
-                    required: operation.requestBody.required,
-                    mediaType,
-                    schema: this.schemaResolver.resolveSchemaReference(mediaTypeObj.schema, swagger),
-                };
-            }
+        await this.runtime.dispose();
+    }
+}
+function isDirectExecution() {
+    const entryPoint = process.argv[1] ?? '';
+    return /(?:^|[/\\])index\.(?:ts|js)$/.test(entryPoint);
+}
+if (isDirectExecution()) {
+    const server = new SwaggerParserServer();
+    let shuttingDown = false;
+    let detachStdioShutdownHooks = null;
+    const shutdown = async (exitCode) => {
+        if (shuttingDown) {
+            return;
         }
-        // Response 정보 추출
-        const responses = {};
-        if (operation.responses) {
-            Object.entries(operation.responses).forEach(([statusCode, response]) => {
-                if (response && typeof response === 'object' && 'content' in response && response.content) {
-                    const content = response.content;
-                    const mediaType = Object.keys(content)[0];
-                    const mediaTypeObj = content[mediaType];
-                    if (mediaTypeObj?.schema) {
-                        responses[statusCode] = {
-                            description: response.description,
-                            mediaType,
-                            schema: this.schemaResolver.resolveSchemaReference(mediaTypeObj.schema, swagger),
-                        };
-                    }
-                }
-                else if (response && typeof response === 'object' && 'description' in response) {
-                    responses[statusCode] = {
-                        description: response.description,
-                    };
-                }
-            });
+        shuttingDown = true;
+        if (detachStdioShutdownHooks) {
+            detachStdioShutdownHooks();
+            detachStdioShutdownHooks = null;
         }
-        const pathDetails = {
-            path,
-            method: method.toUpperCase(),
-            operationId: operation.operationId,
-            summary: operation.summary,
-            description: operation.description,
-            tags: operation.tags,
-            parameters,
-            requestBody: requestBody || undefined,
-            responses,
-        };
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify(pathDetails, null, 2),
-                },
-            ],
-        };
-    }
-    async resolveSchema(url, ref) {
-        const swagger = await this.getSwagger(url);
-        const resolved = this.schemaResolver.resolveRef(ref, swagger);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        ref,
-                        resolved,
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async run() {
-        const transport = new StdioServerTransport();
-        await this.server.connect(transport);
-        console.error('Swagger Parser MCP Server running on stdio');
-    }
+        await server.dispose().catch(() => undefined);
+        process.exit(exitCode);
+    };
+    process.on('SIGINT', () => {
+        void shutdown(0);
+    });
+    process.on('SIGTERM', () => {
+        void shutdown(0);
+    });
+    process.on('uncaughtException', error => {
+        console.error(error);
+        void shutdown(1);
+    });
+    process.on('unhandledRejection', reason => {
+        console.error(reason);
+        void shutdown(1);
+    });
+    detachStdioShutdownHooks = attachStdioShutdownHooks(process.stdin, () => {
+        void shutdown(0);
+    });
+    server
+        .startWebServer()
+        .then(() => server.run(() => {
+        void shutdown(0);
+    }))
+        .catch(error => {
+        console.error(error);
+        void shutdown(1);
+    });
 }
-// 서버 실행
-const server = new SwaggerParserServer();
-server.run().catch(console.error);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/infrastructure/postgres/migrationRunner.d.ts

@@ -0,0 +1,14 @@
+import type { Pool } from 'pg';
+type Queryable = Pick<Pool, 'query'>;
+export interface MigrationRunOptions {
+    migrationsDirectory?: string;
+}
+export interface MigrationRunSummary {
+    migrationsDirectory: string;
+    applied: string[];
+    skipped: string[];
+}
+export declare function runPostgresMigrations(db: Queryable, options?: MigrationRunOptions): Promise<MigrationRunSummary>;
+export declare function getDefaultMigrationsDirectory(): string;
+export {};
+//# sourceMappingURL=migrationRunner.d.ts.map

package/dist/infrastructure/postgres/migrationRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrationRunner.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/postgres/migrationRunner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B,KAAK,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAYrC,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA0JD,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,SAAS,EACb,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CA+B9B;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD"}

package/dist/infrastructure/postgres/migrationRunner.js

@@ -0,0 +1,161 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+function resolveDefaultMigrationsDirectory() {
+    const envOverride = process.env.SNAPSHOT_MIGRATIONS_DIR?.trim();
+    if (envOverride) {
+        return envOverride;
+    }
+    const entrypointCandidates = [];
+    const entrypoint = process.argv[1];
+    if (entrypoint && path.isAbsolute(entrypoint)) {
+        const entrypointDirectory = path.dirname(entrypoint);
+        entrypointCandidates.push(path.join(entrypointDirectory, 'migrations'));
+        entrypointCandidates.push(path.join(entrypointDirectory, 'infrastructure', 'postgres', 'migrations'));
+        const segments = entrypoint.split(path.sep);
+        const distIndex = segments.lastIndexOf('dist');
+        if (distIndex >= 0) {
+            const distRoot = segments.slice(0, distIndex + 1).join(path.sep);
+            entrypointCandidates.push(path.join(distRoot, 'infrastructure', 'postgres', 'migrations'));
+        }
+    }
+    const candidateDirectories = [
+        ...entrypointCandidates,
+        path.join(process.cwd(), 'src', 'infrastructure', 'postgres', 'migrations'),
+        path.join(process.cwd(), 'dist', 'infrastructure', 'postgres', 'migrations'),
+    ];
+    const existingDirectory = candidateDirectories.find(directory => existsSync(directory));
+    return existingDirectory ?? candidateDirectories[0];
+}
+const DEFAULT_MIGRATIONS_DIRECTORY = resolveDefaultMigrationsDirectory();
+function isSqlMigrationFile(filename) {
+    return /^\d+.*\.sql$/i.test(filename);
+}
+function compareMigrationFilename(left, right) {
+    const parse = (filename) => {
+        const match = filename.match(/^(\d+)(?:[-_]?(.+))?\.sql$/i);
+        if (!match) {
+            return {
+                numericVersion: Number.MAX_SAFE_INTEGER,
+                suffix: filename.toLowerCase(),
+            };
+        }
+        return {
+            numericVersion: Number.parseInt(match[1], 10),
+            suffix: (match[2] ?? '').toLowerCase(),
+        };
+    };
+    const leftKey = parse(left);
+    const rightKey = parse(right);
+    if (leftKey.numericVersion !== rightKey.numericVersion) {
+        return leftKey.numericVersion - rightKey.numericVersion;
+    }
+    const suffixCompare = leftKey.suffix.localeCompare(rightKey.suffix);
+    if (suffixCompare !== 0) {
+        return suffixCompare;
+    }
+    return left.localeCompare(right);
+}
+async function ensureMigrationHistoryTable(db) {
+    await db.query(`
+    CREATE TABLE IF NOT EXISTS schema_migrations (
+      version TEXT PRIMARY KEY,
+      filename TEXT NOT NULL,
+      applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+  `);
+}
+async function getAppliedMigrationVersions(db) {
+    const result = await db.query(`
+    SELECT version
+    FROM schema_migrations
+    ORDER BY version ASC;
+  `);
+    return new Set(result.rows.map(row => row.version));
+}
+async function loadMigrationFiles(migrationsDirectory) {
+    let directoryEntries;
+    try {
+        directoryEntries = await readdir(migrationsDirectory, { withFileTypes: true, encoding: 'utf8' });
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code === 'ENOENT') {
+            throw new Error(`Migration directory not found: ${migrationsDirectory}. Set SNAPSHOT_MIGRATIONS_DIR or ensure migrations are packaged.`);
+        }
+        throw error;
+    }
+    const filenames = directoryEntries
+        .filter(entry => entry.isFile() && isSqlMigrationFile(entry.name))
+        .map(entry => entry.name)
+        .sort(compareMigrationFilename);
+    if (filenames.length === 0) {
+        throw new Error(`No SQL migration files found in directory: ${migrationsDirectory}`);
+    }
+    const files = [];
+    for (const filename of filenames) {
+        const sql = await readFile(path.join(migrationsDirectory, filename), 'utf8');
+        files.push({
+            version: filename,
+            filename,
+            sql,
+        });
+    }
+    return files;
+}
+async function applyMigration(db, migration) {
+    await db.query('BEGIN');
+    try {
+        await db.query(migration.sql);
+        const insertResult = await db.query(`
+      INSERT INTO schema_migrations (version, filename)
+      VALUES ($1, $2);
+      `, [migration.version, migration.filename]);
+        if (insertResult.rowCount !== 1) {
+            throw new Error(`Failed to persist migration history row for ${migration.filename}.`);
+        }
+        await db.query('COMMIT');
+        return true;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        if (/duplicate key/i.test(message) || /already exists/i.test(message)) {
+            await db.query('ROLLBACK');
+            return false;
+        }
+        await db.query('ROLLBACK');
+        throw new Error(`Failed to apply migration ${migration.filename}: ${message}`);
+    }
+}
+export async function runPostgresMigrations(db, options = {}) {
+    const migrationsDirectory = options.migrationsDirectory ?? DEFAULT_MIGRATIONS_DIRECTORY;
+    await ensureMigrationHistoryTable(db);
+    const migrations = await loadMigrationFiles(migrationsDirectory);
+    const appliedVersions = await getAppliedMigrationVersions(db);
+    const applied = [];
+    const skipped = [];
+    for (const migration of migrations) {
+        if (appliedVersions.has(migration.version)) {
+            skipped.push(migration.filename);
+            continue;
+        }
+        const created = await applyMigration(db, migration);
+        if (created) {
+            applied.push(migration.filename);
+            appliedVersions.add(migration.version);
+        }
+        else {
+            skipped.push(migration.filename);
+            appliedVersions.add(migration.version);
+        }
+    }
+    return {
+        migrationsDirectory,
+        applied,
+        skipped,
+    };
+}
+export function getDefaultMigrationsDirectory() {
+    return DEFAULT_MIGRATIONS_DIRECTORY;
+}
+//# sourceMappingURL=migrationRunner.js.map

package/dist/infrastructure/postgres/migrationRunner.js.map

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

package/dist/infrastructure/postgres/migrations/001_snapshot_schema.sql

@@ -0,0 +1,29 @@
+CREATE TABLE IF NOT EXISTS projects (
+  id BIGSERIAL PRIMARY KEY,
+  project_key TEXT NOT NULL UNIQUE,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS sources (
+  id BIGSERIAL PRIMARY KEY,
+  project_id BIGINT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  swagger_url TEXT NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  UNIQUE (project_id, swagger_url)
+);
+
+CREATE TABLE IF NOT EXISTS snapshots (
+  id BIGSERIAL PRIMARY KEY,
+  source_id BIGINT NOT NULL REFERENCES sources(id) ON DELETE CASCADE,
+  spec_hash TEXT NOT NULL,
+  document_fingerprint TEXT NOT NULL,
+  canonical_snapshot JSONB NOT NULL,
+  captured_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  UNIQUE (source_id, spec_hash)
+);
+
+CREATE INDEX IF NOT EXISTS idx_snapshots_source_captured_desc
+ON snapshots (source_id, captured_at DESC, id DESC);
+
+CREATE INDEX IF NOT EXISTS idx_snapshots_source_spec_hash
+ON snapshots (source_id, spec_hash);