@airmcp-dev/core 0.1.0

package/dist/server/define-server.js

@@ -0,0 +1,175 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — server/define-server.ts
+//
+// defineServer() — air의 심장.
+// 모든 것을 합쳐서 하나의 MCP 서버를 만든다.
+//
+// shield/meter 설정이 있으면 자동으로 보안/측정 미들웨어가 체인에 등록된다.
+// 사용자는 handler 로직만 작성하면 나머지는 프레임워크가 처리.
+//
+// @example
+// ```ts
+// import { defineServer, defineTool } from '@airmcp-dev/core';
+//
+// export default defineServer({
+//   name: 'my-tool',
+//   shield: {
+//     enabled: true,
+//     policies: [{ name: 'block-admin', target: 'admin_*', action: 'deny' }],
+//     threatDetection: true,
+//     rateLimit: { maxCalls: 100, windowMs: 60000 },
+//   },
+//   meter: { classify: true, trackCalls: true },
+//   tools: [
+//     defineTool('search', {
+//       params: { query: 'string' },
+//       handler: async ({ query }) => doSearch(query),
+//     }),
+//   ],
+// });
+// ```
+import { ServerRunner } from './server-runner.js';
+import { MiddlewareChain } from '../middleware/chain.js';
+import { validationMiddleware } from '../middleware/before-hook.js';
+import { errorBoundaryMiddleware } from '../middleware/error-handler.js';
+import { createShieldMiddleware } from '../middleware/shield-middleware.js';
+import { createMeterMiddleware } from '../middleware/meter-middleware.js';
+import { McpErrors } from '../middleware/error-handler.js';
+import { createRequestContext } from '../context/request-context.js';
+import { PluginManager } from '../plugin/plugin-manager.js';
+import { builtinLoggerPlugin } from '../plugin/builtin/logger.js';
+import { builtinMetricsPlugin } from '../plugin/builtin/metrics.js';
+/**
+ * MCP 서버를 정의한다.
+ *
+ * 내장 기능 (자동 적용):
+ * - 입력 검증 (zod)
+ * - 에러 → MCP 프로토콜 변환
+ * - 로깅 (builtin logger plugin)
+ * - 보안 (shield 설정 시: 정책, 위협탐지, 레이트리밋, 감사)
+ * - 측정 (meter 설정 시: 7-Layer 분류, 호출 추적, 지연시간)
+ * - Graceful shutdown (SIGTERM/SIGINT)
+ */
+export function defineServer(options) {
+    // ── 1. 미들웨어 체인 구성 ──
+    const chain = new MiddlewareChain();
+    // 내장 미들웨어 (최우선)
+    chain.add(errorBoundaryMiddleware());
+    chain.add(validationMiddleware());
+    // ── 2. Shield 자동 등록 ──
+    if (options.shield?.enabled) {
+        chain.add(createShieldMiddleware(options.shield));
+    }
+    // ── 3. Meter 자동 등록 ──
+    if (options.meter?.enabled !== false) {
+        chain.add(createMeterMiddleware(options.meter || {}));
+    }
+    // ── 4. 플러그인 관리 ──
+    const pluginManager = new PluginManager();
+    // 내장 플러그인 (로깅 + 메트릭)
+    const logLevel = options.logging?.level || 'info';
+    pluginManager.register(builtinLoggerPlugin(logLevel));
+    if (options.metrics?.enabled !== false) {
+        pluginManager.register(builtinMetricsPlugin());
+    }
+    // 사용자 플러그인
+    if (options.use) {
+        for (const p of options.use) {
+            pluginManager.register(p);
+        }
+    }
+    // 플러그인 미들웨어 수집 → 체인에 추가
+    chain.addAll(pluginManager.collectMiddleware());
+    // 사용자 미들웨어 (마지막)
+    if (options.middleware) {
+        chain.addAll(options.middleware);
+    }
+    // ── 5. 서버 러너 생성 ──
+    const config = {
+        name: options.name,
+        version: options.version,
+        description: options.description,
+        transport: options.transport,
+        storage: options.storage,
+        logging: options.logging,
+        metrics: options.metrics,
+        shield: options.shield,
+        meter: options.meter,
+        dev: options.dev,
+    };
+    const runner = new ServerRunner(config, chain);
+    // ── 6. 플러그인 컨텍스트 생성 ──
+    const pluginCtx = pluginManager.createContext(config.name, config, runner.getContext().state);
+    // ── 7. 도구 등록 (사용자 + 플러그인) ──
+    const allTools = [...(options.tools || []), ...pluginManager.collectTools()];
+    for (const tool of allTools) {
+        const finalTool = pluginManager.hookRunner.runOnToolRegister(tool, pluginCtx);
+        runner.registerTool(finalTool);
+    }
+    // ── 8. 리소스 등록 ──
+    const allResources = [...(options.resources || []), ...pluginManager.collectResources()];
+    for (const resource of allResources) {
+        runner.registerResource(resource);
+    }
+    // ── 9. 프롬프트 등록 ──
+    if (options.prompts) {
+        for (const prompt of options.prompts) {
+            runner.registerPrompt(prompt);
+        }
+    }
+    // ── 10. AirServer 인터페이스 반환 ──
+    const server = {
+        get name() {
+            return config.name;
+        },
+        async start() {
+            await pluginManager.hookRunner.runOnInit(pluginCtx);
+            await pluginManager.hookRunner.runOnStart(pluginCtx);
+            await runner.start();
+        },
+        async stop() {
+            await pluginManager.hookRunner.runOnStop(pluginCtx);
+            await runner.stop();
+        },
+        status() {
+            return runner.status();
+        },
+        tools() {
+            return runner.getTools();
+        },
+        resources() {
+            return allResources;
+        },
+        async callTool(toolName, params) {
+            const tool = runner.getTools().find((t) => t.name === toolName);
+            if (!tool)
+                throw McpErrors.toolNotFound(toolName);
+            const reqCtx = createRequestContext(config.name, runner.getContext().state);
+            const content = await chain.execute(tool, params || {}, reqCtx);
+            // content는 McpContent[] 형태 — 텍스트 결과만 추출
+            if (Array.isArray(content) && content.length > 0) {
+                const first = content[0];
+                if (first && typeof first === 'object' && 'text' in first) {
+                    return first.text;
+                }
+            }
+            return content;
+        },
+        addTool(tool) {
+            const finalTool = pluginManager.hookRunner.runOnToolRegister(tool, pluginCtx);
+            runner.registerTool(finalTool);
+        },
+        addMiddleware(mw) {
+            chain.add(mw);
+        },
+        addPlugin(plugin) {
+            pluginManager.register(plugin);
+            chain.addAll(pluginManager.collectMiddleware());
+        },
+        get state() {
+            return runner.getContext().state;
+        },
+    };
+    return server;
+}
+//# sourceMappingURL=define-server.js.map

package/dist/server/define-server.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,4 @@
+export { defineServer } from './define-server.js';
+export { ServerRunner } from './server-runner.js';
+export { onShutdown, clearShutdownHandlers } from './lifecycle.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,6 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — server/index.ts (re-export only)
+export { defineServer } from './define-server.js';
+export { ServerRunner } from './server-runner.js';
+export { onShutdown, clearShutdownHandlers } from './lifecycle.js';
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,sDAAsD;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/server/lifecycle.d.ts

@@ -0,0 +1,3 @@
+export declare function onShutdown(handler: () => Promise<void>): void;
+export declare function clearShutdownHandlers(): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/server/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/server/lifecycle.ts"],"names":[],"mappings":"AAOA,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,QAGtD;AAED,wBAAgB,qBAAqB,SAEpC"}

package/dist/server/lifecycle.js

@@ -0,0 +1,32 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — server/lifecycle.ts
+// Graceful shutdown + 시그널 핸들링
+let shutdownHandlers = [];
+let registered = false;
+export function onShutdown(handler) {
+    shutdownHandlers.push(handler);
+    registerSignals();
+}
+export function clearShutdownHandlers() {
+    shutdownHandlers = [];
+}
+function registerSignals() {
+    if (registered)
+        return;
+    registered = true;
+    const shutdown = async (signal) => {
+        console.log(`\n[air] ${signal} received — shutting down...`);
+        for (const handler of shutdownHandlers) {
+            try {
+                await handler();
+            }
+            catch (err) {
+                console.error(`[air] Shutdown error: ${err.message}`);
+            }
+        }
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGINT', () => shutdown('SIGINT'));
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/server/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/server/lifecycle.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yCAAyC;AACzC,8BAA8B;AAE9B,IAAI,gBAAgB,GAA+B,EAAE,CAAC;AACtD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,MAAM,UAAU,UAAU,CAAC,OAA4B;IACrD,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,eAAe,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,gBAAgB,GAAG,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,UAAU;QAAE,OAAO;IACvB,UAAU,GAAG,IAAI,CAAC;IAElB,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,8BAA8B,CAAC,CAAC;QAC7D,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,OAAO,EAAE,CAAC;YAClB,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,yBAAyB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/server/server-runner.d.ts

@@ -0,0 +1,42 @@
+import type { AirToolDef } from '../types/tool.js';
+import type { AirResourceDef } from '../types/resource.js';
+import type { AirPromptDef } from '../types/prompt.js';
+import type { AirConfig } from '../types/config.js';
+import { MiddlewareChain } from '../middleware/chain.js';
+import { ServerContext } from '../context/server-context.js';
+export declare class ServerRunner {
+    private mcp;
+    private config;
+    private serverCtx;
+    private middlewareChain;
+    private tools;
+    constructor(config: AirConfig, middlewareChain: MiddlewareChain);
+    /** 도구 등록 — MCP SDK에 zod 스키마 + 핸들러 래퍼를 연결 */
+    registerTool(tool: AirToolDef): void;
+    /** 리소스 등록 */
+    registerResource(resource: AirResourceDef): void;
+    /** 프롬프트 등록 */
+    registerPrompt(prompt: AirPromptDef): void;
+    /** 서버 시작 — transport 감지 + 연결 */
+    start(): Promise<void>;
+    /** SSE transport 시작 — GET /sse + POST /message */
+    /** SSE transport 시작 — GET /sse + POST /message, 세션별 독립 McpServer */
+    private startSSE;
+    /** 서버 중지 */
+    stop(): Promise<void>;
+    /** 서버 상태 반환 */
+    status(): {
+        name: string;
+        version: string;
+        state: "error" | "idle" | "starting" | "running" | "stopping" | "stopped";
+        uptime: number;
+        toolCount: number;
+        resourceCount: number;
+        transport: import("../index.js").TransportType;
+    };
+    /** 등록된 도구 목록 */
+    getTools(): AirToolDef[];
+    /** 서버 컨텍스트 */
+    getContext(): ServerContext;
+}
+//# sourceMappingURL=server-runner.d.ts.map

package/dist/server/server-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-runner.d.ts","sourceRoot":"","sources":["../../src/server/server-runner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAM7D,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,KAAK,CAAoB;gBAErB,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe;IAU/D,4CAA4C;IAC5C,YAAY,CAAC,IAAI,EAAE,UAAU;IAmB7B,aAAa;IACb,gBAAgB,CAAC,QAAQ,EAAE,cAAc;IAgCzC,cAAc;IACd,cAAc,CAAC,MAAM,EAAE,YAAY;IAYnC,gCAAgC;IAC1B,KAAK;IA0DX,kDAAkD;IAChD,oEAAoE;YACxD,QAAQ;IA0GtB,YAAY;IACN,IAAI;IAOV,eAAe;IACf,MAAM;;;;;;;;;IAYN,gBAAgB;IAChB,QAAQ;IAIR,cAAc;IACd,UAAU;CAGX"}

package/dist/server/server-runner.js

@@ -0,0 +1,255 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/core — server/server-runner.ts
+// MCP SDK 서버에 도구/리소스/프롬프트를 등록하고 transport를 연결하는 런타임
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { paramsToZodSchema } from '../tool/tool-schema.js';
+import { createRequestContext } from '../context/request-context.js';
+import { ServerContext } from '../context/server-context.js';
+import { detectTransport } from '../transport/auto-detect.js';
+import { createStdioTransport } from '../transport/stdio-adapter.js';
+import { createHttpTransport } from '../transport/http-adapter.js';
+import { onShutdown } from './lifecycle.js';
+export class ServerRunner {
+    mcp;
+    config;
+    serverCtx;
+    middlewareChain;
+    tools = [];
+    constructor(config, middlewareChain) {
+        this.config = config;
+        this.middlewareChain = middlewareChain;
+        this.serverCtx = new ServerContext(config.name, config.version || '0.1.0');
+        this.mcp = new McpServer({
+            name: config.name,
+            version: config.version || '0.1.0',
+        });
+    }
+    /** 도구 등록 — MCP SDK에 zod 스키마 + 핸들러 래퍼를 연결 */
+    registerTool(tool) {
+        this.tools.push(tool);
+        const zodSchema = paramsToZodSchema(tool.params);
+        if (zodSchema) {
+            this.mcp.tool(tool.name, tool.description || '', zodSchema.shape, async (params) => {
+                const reqCtx = createRequestContext(this.config.name, this.serverCtx.state);
+                const content = await this.middlewareChain.execute(tool, params || {}, reqCtx);
+                return { content };
+            });
+        }
+        else {
+            this.mcp.tool(tool.name, tool.description || '', async (params) => {
+                const reqCtx = createRequestContext(this.config.name, this.serverCtx.state);
+                const content = await this.middlewareChain.execute(tool, params || {}, reqCtx);
+                return { content };
+            });
+        }
+    }
+    /** 리소스 등록 */
+    registerResource(resource) {
+        const metadata = {
+            description: resource.description,
+            mimeType: resource.mimeType,
+        };
+        // MCP SDK registerResource(name, uri:string, metadata, callback)
+        // uri는 반드시 string이어야 template 분기를 안 탄다
+        const uri = String(resource.uri);
+        try {
+            this.mcp.registerResource(resource.name, uri, metadata, async (reqUri) => {
+                const ctx = { requestId: crypto.randomUUID(), serverName: this.config.name };
+                const result = await resource.handler(reqUri.href, ctx);
+                const content = typeof result === 'string'
+                    ? { uri: reqUri.href, text: result }
+                    : 'text' in result
+                        ? { uri: reqUri.href, text: result.text, mimeType: result.mimeType }
+                        : { uri: reqUri.href, blob: result.blob, mimeType: result.mimeType };
+                return { contents: [content] };
+            });
+        }
+        catch (err) {
+            console.error(`[air] Failed to register resource "${resource.name}" (uri: "${uri}", type: ${typeof uri}): ${err.message}\n${err.stack}`);
+        }
+    }
+    /** 프롬프트 등록 */
+    registerPrompt(prompt) {
+        this.mcp.prompt(prompt.name, prompt.description || '', async (args) => {
+            const messages = await prompt.handler(args || {});
+            return {
+                messages: messages.map((m) => ({
+                    role: m.role,
+                    content: { type: 'text', text: m.content },
+                })),
+            };
+        });
+    }
+    /** 서버 시작 — transport 감지 + 연결 */
+    async start() {
+        this.serverCtx.status = 'starting';
+        const transportType = detectTransport(this.config.transport);
+        console.log(`[air] Starting "${this.config.name}" (${transportType} transport, ${this.tools.length} tools)`);
+        if (transportType === 'stdio') {
+            const transport = createStdioTransport();
+            onShutdown(async () => {
+                this.serverCtx.status = 'stopping';
+                await this.mcp.close();
+                this.serverCtx.status = 'stopped';
+            });
+            await this.mcp.connect(transport);
+        }
+        else if (transportType === 'sse') {
+            // ── SSE Transport ──
+            // mcp-proxy 호환: GET /sse → SSE 스트림, POST /message → 메시지 수신
+            await this.startSSE();
+        }
+        else if (transportType === 'http') {
+            // ── Streamable HTTP Transport ──
+            const { createServer } = await import('http');
+            const httpTransport = createHttpTransport(this.config.transport);
+            const port = this.config.transport?.port || this.config.dev?.port || 3100;
+            const server = createServer(async (req, res) => {
+                if (req.method === 'POST') {
+                    await httpTransport.handleRequest(req, res);
+                }
+                else if (req.method === 'GET') {
+                    res.writeHead(200, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify(this.status()));
+                }
+                else if (req.method === 'DELETE') {
+                    await httpTransport.handleRequest(req, res);
+                }
+                else {
+                    res.writeHead(405).end();
+                }
+            });
+            await this.mcp.connect(httpTransport);
+            server.listen(port, () => {
+                console.log(`[air] HTTP server listening on port ${port}`);
+            });
+            onShutdown(async () => {
+                this.serverCtx.status = 'stopping';
+                server.close();
+                await this.mcp.close();
+                this.serverCtx.status = 'stopped';
+            });
+        }
+        this.serverCtx.status = 'running';
+    }
+    /** SSE transport 시작 — GET /sse + POST /message */
+    /** SSE transport 시작 — GET /sse + POST /message, 세션별 독립 McpServer */
+    async startSSE() {
+        const { createServer } = await import('http');
+        const port = this.config.transport?.port || this.config.dev?.port || 3100;
+        // 세션별 SSE transport + McpServer를 관리
+        const sessions = new Map();
+        const httpServer = createServer(async (req, res) => {
+            const url = new URL(req.url || '/', `http://${req.headers.host || 'localhost'}`);
+            // CORS 헤더
+            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+            res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+            if (req.method === 'OPTIONS') {
+                res.writeHead(204).end();
+                return;
+            }
+            // GET /sse — 새 세션 생성 + SSE 연결
+            if (req.method === 'GET' && url.pathname === '/sse') {
+                const transport = new SSEServerTransport('/message', res);
+                // 세션별 새 McpServer 인스턴스 생성
+                const sessionServer = new McpServer({
+                    name: this.config.name,
+                    version: this.config.version || '0.1.0',
+                });
+                // 모든 도구를 세션 서버에 등록
+                for (const tool of this.tools) {
+                    const zodSchema = paramsToZodSchema(tool.params);
+                    if (zodSchema) {
+                        sessionServer.tool(tool.name, tool.description || '', zodSchema.shape, async (params) => {
+                            const reqCtx = createRequestContext(this.config.name, this.serverCtx.state);
+                            const content = await this.middlewareChain.execute(tool, params || {}, reqCtx);
+                            return { content };
+                        });
+                    }
+                    else {
+                        sessionServer.tool(tool.name, tool.description || '', async (params) => {
+                            const reqCtx = createRequestContext(this.config.name, this.serverCtx.state);
+                            const content = await this.middlewareChain.execute(tool, params || {}, reqCtx);
+                            return { content };
+                        });
+                    }
+                }
+                sessions.set(transport.sessionId, { transport, server: sessionServer });
+                console.log(`[air] SSE client connected (session: ${transport.sessionId})`);
+                transport.onclose = () => {
+                    sessions.delete(transport.sessionId);
+                    console.log(`[air] SSE client disconnected (session: ${transport.sessionId})`);
+                };
+                await sessionServer.connect(transport);
+                return;
+            }
+            // POST /message?sessionId=xxx — 메시지 수신
+            if (req.method === 'POST' && url.pathname === '/message') {
+                const sessionId = url.searchParams.get('sessionId');
+                if (!sessionId) {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Missing sessionId' }));
+                    return;
+                }
+                const session = sessions.get(sessionId);
+                if (!session) {
+                    res.writeHead(404, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Session not found' }));
+                    return;
+                }
+                await session.transport.handlePostMessage(req, res);
+                return;
+            }
+            // GET / — 상태 확인
+            if (req.method === 'GET' && url.pathname === '/') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(this.status()));
+                return;
+            }
+            res.writeHead(404).end();
+        });
+        httpServer.listen(port, () => {
+            console.log(`[air] SSE server listening on port ${port}`);
+        });
+        onShutdown(async () => {
+            this.serverCtx.status = 'stopping';
+            for (const session of sessions.values()) {
+                await session.transport.close();
+            }
+            sessions.clear();
+            httpServer.close();
+            await this.mcp.close();
+            this.serverCtx.status = 'stopped';
+        });
+    }
+    /** 서버 중지 */
+    async stop() {
+        this.serverCtx.status = 'stopping';
+        await this.mcp.close();
+        this.serverCtx.status = 'stopped';
+        console.log(`[air] "${this.config.name}" stopped`);
+    }
+    /** 서버 상태 반환 */
+    status() {
+        return {
+            name: this.serverCtx.name,
+            version: this.serverCtx.version,
+            state: this.serverCtx.status,
+            uptime: this.serverCtx.uptime,
+            toolCount: this.tools.length,
+            resourceCount: 0,
+            transport: detectTransport(this.config.transport),
+        };
+    }
+    /** 등록된 도구 목록 */
+    getTools() {
+        return [...this.tools];
+    }
+    /** 서버 컨텍스트 */
+    getContext() {
+        return this.serverCtx;
+    }
+}
+//# sourceMappingURL=server-runner.js.map

package/dist/server/server-runner.js.map

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

package/dist/storage/file-store.d.ts

@@ -0,0 +1,25 @@
+import type { StorageAdapter, QueryOptions } from '../types/storage.js';
+export declare class FileStore implements StorageAdapter {
+    private basePath;
+    private cache;
+    private dirty;
+    private flushTimer;
+    constructor(basePath?: string);
+    init(): Promise<void>;
+    set(namespace: string, key: string, value: any, ttl?: number): Promise<void>;
+    get<T = any>(namespace: string, key: string): Promise<T | null>;
+    delete(namespace: string, key: string): Promise<boolean>;
+    list(namespace: string, prefix?: string): Promise<string[]>;
+    entries<T = any>(namespace: string, prefix?: string): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    append(namespace: string, entry: any): Promise<void>;
+    query(namespace: string, opts?: QueryOptions): Promise<any[]>;
+    close(): Promise<void>;
+    private loadNamespace;
+    private flushNamespace;
+    private flushAll;
+    private cleanExpired;
+}
+//# sourceMappingURL=file-store.d.ts.map

package/dist/storage/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../src/storage/file-store.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxE,qBAAa,SAAU,YAAW,cAAc;IAC9C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,UAAU,CAA+C;gBAErD,QAAQ,CAAC,EAAE,MAAM;IAIvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5E,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAc/D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOxD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW3D,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAa/F,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAoC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAWd,aAAa;YAoBb,cAAc;YAad,QAAQ;IAOtB,OAAO,CAAC,YAAY;CASrB"}