@awarecorp/mcp-logger 0.0.2-dev.0 → 0.0.2-dev.1

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

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

package/dist/cli/cli.js

@@ -1,2 +1,85 @@
 #!/usr/bin/env node
-import{spawn as e}from"child_process";import{program as r}from"commander";import{NodeSDK as t}from"@opentelemetry/sdk-node";import{OTLPTraceExporter as o}from"@opentelemetry/exporter-trace-otlp-http";import{Resource as s}from"@opentelemetry/resources";import{trace as i,SpanStatusCode as n}from"@opentelemetry/api";import{Transform as c}from"stream";const a="https://aware.mcypher.com/v1/traces",g="1.0.0";let d=null,p=null,u=!1;function l(){return p}async function m(){if(d)try{await d.shutdown(),d=null,p=null,u=!1}catch(e){console.error("[MCP Logger] Error shutting down telemetry:",e)}}function h(e,r=1e4){try{const t=JSON.stringify(e);return t.length>r?t.slice(0,r)+"... (truncated)":t}catch(e){return null}}class f extends c{buffer="";direction;debug;constructor(e,r=!1){super(),this.direction=e,this.debug=r}_transform(e,r,t){try{this.push(e),this.buffer+=e.toString(),this.buffer.length>1e6&&(this.debug&&console.error("[MCP Logger CLI] Buffer size exceeded, clearing..."),this.buffer=""),this.tryParseMessages(),t()}catch(e){t(e)}}tryParseMessages(){const e=this.buffer.split("\n");this.buffer=e.pop()||"";for(const r of e){const e=r.trim();if(e)try{const r=JSON.parse(e);this.traceMessage(r).catch(e=>{this.debug&&console.error("[MCP Logger CLI] Trace error:",e)})}catch(r){this.debug&&console.error("[MCP Logger CLI] Failed to parse:",e)}}}async traceMessage(e){const r=l();if(!r)return void(this.debug&&console.error("[MCP Logger CLI] Tracer not initialized"));const t=e.method?`mcp.${e.method}`:void 0!==e.id?"mcp.response":"mcp.notification";return new Promise(o=>{r.startActiveSpan(t,r=>{try{if(function(e,r){for(const[t,o]of Object.entries(r))null!=o&&e.setAttribute(t,o)}(r,{"mcp.direction":this.direction,"mcp.jsonrpc":e.jsonrpc||"2.0"}),void 0!==e.id&&r.setAttribute("mcp.id",String(e.id)),e.method&&r.setAttribute("mcp.method",e.method),e.params){const t=h(e.params);t&&(r.setAttribute("mcp.params.size",t.length),t.length<1e3&&r.setAttribute("mcp.params",t))}const t=h(e);t&&function(e,r,t,o){try{t?e.addEvent(r,t):e.addEvent(r)}catch(e){o&&console.error("[MCP Logger] Failed to add span event:",e)}}(r,`mcp.${this.direction}`,{message:t,timestamp:Date.now()},this.debug),this.debug&&console.error(`[MCP Logger CLI] ${this.direction}:`,JSON.stringify(e,null,2)),e.error?(r.setAttribute("mcp.error",!0),r.setAttribute("mcp.error.code",e.error.code),r.setAttribute("mcp.error.message",e.error.message),r.setStatus({code:n.ERROR,message:e.error.message})):function(e){e.setStatus({code:n.OK})}(r)}catch(e){this.debug&&console.error("[MCP Logger CLI] Error in span:",e),r.setStatus({code:n.ERROR,message:String(e)})}finally{r.end(),o()}})})}_flush(e){try{if(this.buffer.trim())try{const e=JSON.parse(this.buffer);this.traceMessage(e).catch(e=>{this.debug&&console.error("[MCP Logger CLI] Trace error:",e)})}catch(e){this.debug&&console.error("[MCP Logger CLI] Failed to parse final buffer:",e)}e()}catch(r){e(r)}}}r.name("mcp-logger").description("Add observability to any MCP server without code changes").version("1.0.0").requiredOption("-k, --api-key <key>","Aware API key").option("-s, --service-name <name>","Service name for identification").option("-d, --debug","Enable debug logging",!1).option("-e, --endpoint <url>","Custom OTLP endpoint").argument("<command...>","MCP server command to wrap").action(async(r,n)=>{try{!function(e){if(u)return e.debug&&console.error("[MCP Logger] Telemetry already initialized, returning existing tracer"),p;const r=e.serviceName||`mcp-server-${Math.random().toString(36).slice(2,8)}`;e.debug&&(console.error("[MCP Logger] Initializing telemetry..."),console.error(`[MCP Logger] Endpoint: ${e.endpoint||a}`),console.error(`[MCP Logger] Service: ${r}`)),d=new t({resource:new s({"service.name":r,"service.version":g}),traceExporter:new o({url:e.endpoint||a,headers:{"x-api-key":e.apiKey}})}),d.start(),p=i.getTracer("mcp-logger",g),u=!0,e.debug&&console.error("[MCP Logger] Telemetry initialized successfully");const n=async()=>{e.debug&&console.error("[MCP Logger] Shutting down telemetry..."),await m()};process.once("SIGTERM",n),process.once("SIGINT",n)}(n),n.debug&&console.error("[MCP Logger CLI] Starting MCP server:",r.join(" "));const[c,...l]=r,h=e(c,l,{stdio:["pipe","pipe","inherit"],env:{...process.env,MCP_LOGGER_ENABLED:"true"}}),b=new f("request",n.debug);process.stdin.pipe(b).pipe(h.stdin);const C=new f("response",n.debug);h.stdout.pipe(C).pipe(process.stdout),h.on("error",async e=>{console.error("[MCP Logger CLI] Failed to start MCP server:",e),await m(),process.exit(1)}),h.on("exit",async(e,r)=>{n.debug&&console.error(`[MCP Logger CLI] MCP server exited with code ${e}, signal ${r}`),await m(),process.exit(e||0)});let y=!1;const L=async e=>{y||(y=!0,n.debug&&console.error(`[MCP Logger CLI] Received ${e}, shutting down...`),h.kill(e),await Promise.race([new Promise(e=>h.once("exit",e)),new Promise(e=>setTimeout(e,5e3))]),await m(),process.exit(0))};process.on("SIGTERM",()=>L("SIGTERM")),process.on("SIGINT",()=>L("SIGINT"))}catch(e){console.error("[MCP Logger CLI] Fatal error:",e),await m(),process.exit(1)}}),r.parse();
+/**
+ * MCP Logger CLI
+ *
+ * MCP 서버를 래핑하여 자동으로 observability를 추가합니다.
+ */
+import { spawn } from 'child_process';
+import { program } from 'commander';
+import { initializeTelemetry, shutdownTelemetry } from '../shared/telemetry.js';
+import { MessageInterceptor } from './interceptor.js';
+program
+    .name('mcp-logger')
+    .description('Add observability to any MCP server without code changes')
+    .version('1.0.0')
+    .requiredOption('-k, --api-key <key>', 'Aware API key')
+    .option('-s, --service-name <name>', 'Service name for identification')
+    .option('-d, --debug', 'Enable debug logging', false)
+    .option('-e, --endpoint <url>', 'Custom OTLP endpoint')
+    .argument('<command...>', 'MCP server command to wrap')
+    .action(async (command, options) => {
+    try {
+        // 1. Telemetry 초기화
+        initializeTelemetry(options);
+        if (options.debug) {
+            console.error('[MCP Logger CLI] Starting MCP server:', command.join(' '));
+        }
+        // 2. MCP 서버 실행
+        const [cmd, ...args] = command;
+        const mcpServer = spawn(cmd, args, {
+            stdio: ['pipe', 'pipe', 'inherit'], // stdin, stdout, stderr
+            env: {
+                ...process.env,
+                // Trace context 전파 (향후 사용)
+                MCP_LOGGER_ENABLED: 'true',
+            },
+        });
+        // 3. stdin 가로채기 (Claude → MCP Server)
+        const requestInterceptor = new MessageInterceptor('request', options.debug);
+        process.stdin.pipe(requestInterceptor).pipe(mcpServer.stdin);
+        // 4. stdout 가로채기 (MCP Server → Claude)
+        const responseInterceptor = new MessageInterceptor('response', options.debug);
+        mcpServer.stdout.pipe(responseInterceptor).pipe(process.stdout);
+        // 5. 에러 처리
+        mcpServer.on('error', async (err) => {
+            console.error('[MCP Logger CLI] Failed to start MCP server:', err);
+            await shutdownTelemetry();
+            process.exit(1);
+        });
+        mcpServer.on('exit', async (code, signal) => {
+            if (options.debug) {
+                console.error(`[MCP Logger CLI] MCP server exited with code ${code}, signal ${signal}`);
+            }
+            await shutdownTelemetry();
+            process.exit(code || 0);
+        });
+        // 6. 시그널 처리 - 한 번만 처리
+        let isShuttingDown = false;
+        const handleShutdown = async (signal) => {
+            if (isShuttingDown)
+                return;
+            isShuttingDown = true;
+            if (options.debug) {
+                console.error(`[MCP Logger CLI] Received ${signal}, shutting down...`);
+            }
+            mcpServer.kill(signal);
+            // MCP 서버가 종료될 때까지 대기 (최대 5초)
+            await Promise.race([
+                new Promise(resolve => mcpServer.once('exit', resolve)),
+                new Promise(resolve => setTimeout(resolve, 5000))
+            ]);
+            await shutdownTelemetry();
+            process.exit(0);
+        };
+        process.on('SIGTERM', () => handleShutdown('SIGTERM'));
+        process.on('SIGINT', () => handleShutdown('SIGINT'));
+    }
+    catch (err) {
+        console.error('[MCP Logger CLI] Fatal error:', err);
+        await shutdownTelemetry();
+        process.exit(1);
+    }
+});
+// CLI 실행
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli/cli.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/cli/interceptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AASnC,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3E;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,KAAK,CAAU;gBAEX,SAAS,EAAE,gBAAgB,EAAE,KAAK,GAAE,OAAe;IAM/D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAwB3F;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;YACW,YAAY;IA+E1B,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;CAsBvD"}

package/dist/cli/interceptor.js

@@ -1 +1,170 @@
-import{Transform as e}from"stream";import"@opentelemetry/api";import"@opentelemetry/sdk-node";import"@opentelemetry/exporter-trace-otlp-http";import"@opentelemetry/resources";class r extends e{buffer="";direction;debug;constructor(e,r=!1){super(),this.direction=e,this.debug=r}_transform(e,r,t){try{this.push(e),this.buffer+=e.toString(),this.buffer.length>1e6&&(this.debug&&console.error("[MCP Logger CLI] Buffer size exceeded, clearing..."),this.buffer=""),this.tryParseMessages(),t()}catch(e){t(e)}}tryParseMessages(){const e=this.buffer.split("\n");this.buffer=e.pop()||"";for(const r of e){const e=r.trim();if(e)try{const r=JSON.parse(e);this.traceMessage(r).catch(e=>{this.debug&&console.error("[MCP Logger CLI] Trace error:",e)})}catch(r){this.debug&&console.error("[MCP Logger CLI] Failed to parse:",e)}}}async traceMessage(e){this.debug&&console.error("[MCP Logger CLI] Tracer not initialized")}_flush(e){try{if(this.buffer.trim())try{const e=JSON.parse(this.buffer);this.traceMessage(e).catch(e=>{this.debug&&console.error("[MCP Logger CLI] Trace error:",e)})}catch(e){this.debug&&console.error("[MCP Logger CLI] Failed to parse final buffer:",e)}e()}catch(r){e(r)}}}export{r as MessageInterceptor};
+/**
+ * JSON-RPC 메시지 가로채기 및 추적
+ *
+ * stdin/stdout을 통과하는 JSON-RPC 메시지를 파싱하여 OpenTelemetry로 추적합니다.
+ */
+import { Transform } from 'stream';
+import { SpanStatusCode } from '@opentelemetry/api';
+import { getTracer } from '../shared/telemetry.js';
+import { setSpanAttributes, addSpanEvent, markSpanSuccess, safeStringify } from '../shared/span-utils.js';
+/**
+ * JSON-RPC 메시지 파싱 및 로깅을 위한 Transform stream
+ */
+export class MessageInterceptor extends Transform {
+    buffer = '';
+    direction;
+    debug;
+    constructor(direction, debug = false) {
+        super();
+        this.direction = direction;
+        this.debug = debug;
+    }
+    _transform(chunk, encoding, callback) {
+        try {
+            // 원본 데이터는 그대로 전달
+            this.push(chunk);
+            // 로깅을 위한 파싱 (비동기)
+            this.buffer += chunk.toString();
+            // 버퍼 크기 제한 (메모리 누수 방지)
+            if (this.buffer.length > 1_000_000) { // 1MB
+                if (this.debug) {
+                    console.error('[MCP Logger CLI] Buffer size exceeded, clearing...');
+                }
+                this.buffer = '';
+            }
+            this.tryParseMessages();
+            callback();
+        }
+        catch (err) {
+            callback(err);
+        }
+    }
+    /**
+     * 버퍼에서 JSON-RPC 메시지 파싱 시도
+     */
+    tryParseMessages() {
+        const lines = this.buffer.split('\n');
+        // 마지막 불완전한 라인은 버퍼에 보관
+        this.buffer = lines.pop() || '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const message = JSON.parse(trimmed);
+                // OpenTelemetry로 로깅 (비동기지만 blocking하지 않음)
+                this.traceMessage(message).catch(err => {
+                    if (this.debug) {
+                        console.error('[MCP Logger CLI] Trace error:', err);
+                    }
+                });
+            }
+            catch (err) {
+                // JSON 파싱 실패는 무시 (MCP 메시지가 아닐 수 있음)
+                if (this.debug) {
+                    console.error('[MCP Logger CLI] Failed to parse:', trimmed);
+                }
+            }
+        }
+    }
+    /**
+     * 메시지를 OpenTelemetry span으로 추적
+     */
+    async traceMessage(message) {
+        const tracer = getTracer();
+        if (!tracer) {
+            if (this.debug) {
+                console.error('[MCP Logger CLI] Tracer not initialized');
+            }
+            return;
+        }
+        const spanName = message.method
+            ? `mcp.${message.method}`
+            : message.id !== undefined
+                ? 'mcp.response'
+                : 'mcp.notification';
+        return new Promise((resolve) => {
+            tracer.startActiveSpan(spanName, (span) => {
+                try {
+                    // 기본 속성 설정
+                    setSpanAttributes(span, {
+                        'mcp.direction': this.direction,
+                        'mcp.jsonrpc': message.jsonrpc || '2.0',
+                    });
+                    if (message.id !== undefined) {
+                        span.setAttribute('mcp.id', String(message.id));
+                    }
+                    if (message.method) {
+                        span.setAttribute('mcp.method', message.method);
+                    }
+                    // params 처리
+                    if (message.params) {
+                        const paramsStr = safeStringify(message.params);
+                        if (paramsStr) {
+                            span.setAttribute('mcp.params.size', paramsStr.length);
+                            if (paramsStr.length < 1000) {
+                                span.setAttribute('mcp.params', paramsStr);
+                            }
+                        }
+                    }
+                    // 이벤트 기록
+                    const messageStr = safeStringify(message);
+                    if (messageStr) {
+                        addSpanEvent(span, `mcp.${this.direction}`, {
+                            message: messageStr,
+                            timestamp: Date.now(),
+                        }, this.debug);
+                    }
+                    if (this.debug) {
+                        console.error(`[MCP Logger CLI] ${this.direction}:`, JSON.stringify(message, null, 2));
+                    }
+                    // 에러 체크
+                    if (message.error) {
+                        span.setAttribute('mcp.error', true);
+                        span.setAttribute('mcp.error.code', message.error.code);
+                        span.setAttribute('mcp.error.message', message.error.message);
+                        span.setStatus({ code: SpanStatusCode.ERROR, message: message.error.message });
+                    }
+                    else {
+                        markSpanSuccess(span);
+                    }
+                }
+                catch (err) {
+                    if (this.debug) {
+                        console.error('[MCP Logger CLI] Error in span:', err);
+                    }
+                    span.setStatus({ code: SpanStatusCode.ERROR, message: String(err) });
+                }
+                finally {
+                    span.end();
+                    resolve();
+                }
+            });
+        });
+    }
+    _flush(callback) {
+        try {
+            // 남은 버퍼 처리
+            if (this.buffer.trim()) {
+                try {
+                    const message = JSON.parse(this.buffer);
+                    this.traceMessage(message).catch(err => {
+                        if (this.debug) {
+                            console.error('[MCP Logger CLI] Trace error:', err);
+                        }
+                    });
+                }
+                catch (err) {
+                    if (this.debug) {
+                        console.error('[MCP Logger CLI] Failed to parse final buffer:', err);
+                    }
+                }
+            }
+            callback();
+        }
+        catch (err) {
+            callback(err);
+        }
+    }
+}
+//# sourceMappingURL=interceptor.js.map

package/dist/cli/interceptor.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,gBAAgB;CAEnD"}

package/dist/cli/types.js

@@ -0,0 +1,5 @@
+/**
+ * CLI 타입 정의
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.d.ts

@@ -1,115 +1,15 @@
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-
 /**
- * 공통 타입 정의
- */
-/**
- * 텔레메트리 초기화 옵션
- */
-interface TelemetryOptions {
-    /**
-     * API Key for authentication (필수)
-     */
-    apiKey: string;
-    /**
-     * 서비스 이름 (옵션)
-     * 지정하지 않으면 자동으로 'mcp-server-{random}' 형식으로 생성
-     */
-    serviceName?: string;
-    /**
-     * 커스텀 OTLP 엔드포인트 (옵션)
-     * 기본값: CONFIG.ENDPOINT
-     */
-    endpoint?: string;
-    /**
-     * 디버그 로그 활성화 (옵션)
-     */
-    debug?: boolean;
-}
-
-/**
- * SDK 타입 정의
- */
-
-/**
- * SDK 초기화 옵션 (TelemetryOptions 확장)
- */
-interface SDKInitOptions extends TelemetryOptions {
-}
-/**
- * MCP Server 타입 (재export)
- */
-type MCPServer = Server;
-
-/**
- * 공통 텔레메트리 레이어
- *
- * OpenTelemetry SDK 초기화 및 관리를 담당합니다.
- * SDK와 CLI 양쪽에서 공통으로 사용됩니다.
- */
-
-/**
- * Telemetry 종료
- */
-declare function shutdownTelemetry(): Promise<void>;
-
-/**
- * MCP Logger SDK
- *
- * MCP 서버에 자동 관측성(Observability)을 추가하는 SDK입니다.
- */
-
-/**
- * MCP 서버에 자동 계측을 추가합니다.
- *
- * 이 함수는 MCP 서버의 모든 요청/응답을 자동으로 로깅하고 추적합니다.
- * OpenTelemetry를 사용하여 traces를 수집하며, 설정된 엔드포인트로 전송합니다.
- *
- * @param server - MCP Server 인스턴스
- * @param options - 초기화 옵션
- *
- * @throws {Error} apiKey가 제공되지 않은 경우
- * @throws {Error} server 인스턴스가 제공되지 않은 경우
- *
- * @example
- * TypeScript 사용 예시:
- * ```typescript
- * import { Server } from '@modelcontextprotocol/sdk/server/index.js';
- * import { initMCPLogger } from '@awarecorp/mcp-logger';
- *
- * const server = new Server({ name: 'my-server', version: '1.0.0' }, {
- *   capabilities: { tools: {} }
- * });
- *
- * initMCPLogger(server, {
- *   apiKey: 'your-api-key',
- *   serviceName: 'my-mcp-server',
- *   debug: true,
- * });
- *
- * server.setRequestHandler('tools/call', async (request) => {
- *   // 이 핸들러는 자동으로 로깅됩니다
- *   return { result: 'success' };
- * });
- * ```
+ * @awarecorp/mcp-logger
  *
- * @example
- * JavaScript 사용 예시:
- * ```javascript
- * const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
- * const { initMCPLogger } = require('@awarecorp/mcp-logger');
+ * Unified MCP observability solution
  *
- * const server = new Server({ name: 'my-server', version: '1.0.0' }, {
- *   capabilities: { tools: {} }
- * });
+ * This package provides:
+ * 1. SDK: For programmatic integration into MCP servers
+ * 2. CLI: For wrapping existing MCP servers without code changes
  *
- * initMCPLogger(server, {
- *   apiKey: process.env.API_KEY,
- *   serviceName: 'my-mcp-server',
- * });
- * ```
+ * NOTE: This entry point ONLY exports the SDK.
+ * CLI functionality is available through the `mcp-logger` binary.
  */
-declare function initMCPLogger(server: MCPServer, options: SDKInitOptions): void;
-
-export { initMCPLogger, shutdownTelemetry as shutdown };
-export type { MCPServer, SDKInitOptions };
+export { initMCPLogger, shutdown } from './sdk/index.js';
+export type { SDKInitOptions, MCPServer } from './sdk/types.js';
+//# 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":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1 +1,21 @@
-import{NodeSDK as e}from"@opentelemetry/sdk-node";import{OTLPTraceExporter as r}from"@opentelemetry/exporter-trace-otlp-http";import{Resource as t}from"@opentelemetry/resources";import{trace as o,SpanStatusCode as n}from"@opentelemetry/api";const s="https://aware.mcypher.com/v1/traces",c="1.0.0";let i=null,a=null,l=!1;function u(){return a}async function g(){if(i)try{await i.shutdown(),i=null,a=null,l=!1}catch(e){console.error("[MCP Logger] Error shutting down telemetry:",e)}}function m(e,r){for(const[t,o]of Object.entries(r))null!=o&&e.setAttribute(t,o)}function p(e,r,t,o){try{t?e.addEvent(r,t):e.addEvent(r)}catch(e){o&&console.error("[MCP Logger] Failed to add span event:",e)}}function d(e,r=1e4){try{const t=JSON.stringify(e);return t.length>r?t.slice(0,r)+"... (truncated)":t}catch(e){return null}}function h(h,f){if(!f.apiKey)throw new Error("[MCP Logger SDK] apiKey is required");if(!h)throw new Error("[MCP Logger SDK] server instance is required");!function(n){if(l)return n.debug&&console.error("[MCP Logger] Telemetry already initialized, returning existing tracer"),a;const u=n.serviceName||`mcp-server-${Math.random().toString(36).slice(2,8)}`;n.debug&&(console.error("[MCP Logger] Initializing telemetry..."),console.error(`[MCP Logger] Endpoint: ${n.endpoint||s}`),console.error(`[MCP Logger] Service: ${u}`)),i=new e({resource:new t({"service.name":u,"service.version":c}),traceExporter:new r({url:n.endpoint||s,headers:{"x-api-key":n.apiKey}})}),i.start(),a=o.getTracer("mcp-logger",c),l=!0,n.debug&&console.error("[MCP Logger] Telemetry initialized successfully");const m=async()=>{n.debug&&console.error("[MCP Logger] Shutting down telemetry..."),await g()};process.once("SIGTERM",m),process.once("SIGINT",m)}(f),function(e,r=!1){const t=u();if(!t)throw new Error("[MCP Logger SDK] Tracer not initialized. Call initMCPLogger first.");const o=e.setRequestHandler.bind(e);e.setRequestHandler=function(e,s){const c=e.shape?.method,i=c?._def?.value||"unknown";return r&&console.log(`[MCP Logger SDK] Instrumenting handler: ${i}`),o(e,async(e,o)=>{const c=`mcp.${i}`;return await t.startActiveSpan(c,{attributes:{"mcp.method":i,"mcp.request.method":e.method}},async t=>{const c=Date.now();try{const i=d(e.params||{});m(t,{"mcp.request.id":"unknown","mcp.request.params.size":i?.length}),i&&i.length<1e3&&t.setAttribute("mcp.request.params",i),p(t,"mcp.request.received",{"request.method":e.method,"request.timestamp":c},r),r&&console.log("[MCP Logger SDK] Request received:",{method:e.method,params:e.params});const a=await s(e,o),l=Date.now(),u=l-c,g=d(a);return m(t,{"mcp.duration_ms":u,"mcp.response.size":g?.length}),g&&g.length<1e3&&t.setAttribute("mcp.response.result",g),p(t,"mcp.response.sent",{"response.timestamp":l,"response.duration_ms":u},r),function(e){e.setStatus({code:n.OK})}(t),r&&console.log(`[MCP Logger SDK] Response sent (${u}ms):`,a),a}catch(e){throw function(e,r,t){const o=r instanceof Error?r.message:"Unknown error",s=r instanceof Error?r.constructor.name:"Error";r instanceof Error&&e.recordException(r),e.setStatus({code:n.ERROR,message:o}),e.setAttribute("error",!0),e.setAttribute("error.type",s),e.setAttribute("error.message",o),t&&console.error("[MCP Logger] Error recorded in span:",r)}(t,e,r),r&&console.error("[MCP Logger SDK] Error occurred:",e),e}finally{t.end()}})})},r&&console.log("[MCP Logger SDK] Server instrumentation complete")}(h,f.debug),f.debug&&console.log("[MCP Logger SDK] ✓ Initialization complete")}export{h as initMCPLogger,g as shutdown};
+/**
+ * @awarecorp/mcp-logger
+ *
+ * Unified MCP observability solution
+ *
+ * This package provides:
+ * 1. SDK: For programmatic integration into MCP servers
+ * 2. CLI: For wrapping existing MCP servers without code changes
+ *
+ * NOTE: This entry point ONLY exports the SDK.
+ * CLI functionality is available through the `mcp-logger` binary.
+ */
+// ============================================================================
+// SDK Exports (PUBLIC API)
+// ============================================================================
+export { initMCPLogger, shutdown } from './sdk/index.js';
+// ============================================================================
+// CLI is NOT exported here
+// Access via: npx @awarecorp/mcp-logger --api-key xxx -- <command>
+// ============================================================================
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAGzD,+EAA+E;AAC/E,2BAA2B;AAC3B,mEAAmE;AACnE,+EAA+E"}

package/dist/sdk/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * MCP Logger SDK
+ *
+ * MCP 서버에 자동 관측성(Observability)을 추가하는 SDK입니다.
+ */
+import type { MCPServer, SDKInitOptions } from './types.js';
+/**
+ * MCP 서버에 자동 계측을 추가합니다.
+ *
+ * 이 함수는 MCP 서버의 모든 요청/응답을 자동으로 로깅하고 추적합니다.
+ * OpenTelemetry를 사용하여 traces를 수집하며, 설정된 엔드포인트로 전송합니다.
+ *
+ * @param server - MCP Server 인스턴스
+ * @param options - 초기화 옵션
+ *
+ * @throws {Error} apiKey가 제공되지 않은 경우
+ * @throws {Error} server 인스턴스가 제공되지 않은 경우
+ *
+ * @example
+ * TypeScript 사용 예시:
+ * ```typescript
+ * import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+ * import { initMCPLogger } from '@awarecorp/mcp-logger';
+ *
+ * const server = new Server({ name: 'my-server', version: '1.0.0' }, {
+ *   capabilities: { tools: {} }
+ * });
+ *
+ * initMCPLogger(server, {
+ *   apiKey: 'your-api-key',
+ *   serviceName: 'my-mcp-server',
+ *   debug: true,
+ * });
+ *
+ * server.setRequestHandler('tools/call', async (request) => {
+ *   // 이 핸들러는 자동으로 로깅됩니다
+ *   return { result: 'success' };
+ * });
+ * ```
+ *
+ * @example
+ * JavaScript 사용 예시:
+ * ```javascript
+ * const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
+ * const { initMCPLogger } = require('@awarecorp/mcp-logger');
+ *
+ * const server = new Server({ name: 'my-server', version: '1.0.0' }, {
+ *   capabilities: { tools: {} }
+ * });
+ *
+ * initMCPLogger(server, {
+ *   apiKey: process.env.API_KEY,
+ *   serviceName: 'my-mcp-server',
+ * });
+ * ```
+ */
+export declare function initMCPLogger(server: MCPServer, options: SDKInitOptions): void;
+/**
+ * SDK를 종료하고 모든 pending traces를 flush합니다.
+ *
+ * 일반적으로 명시적으로 호출할 필요는 없습니다.
+ * 프로세스 종료 시 자동으로 처리됩니다.
+ */
+export { shutdownTelemetry as shutdown } from '../shared/telemetry.js';
+export type { SDKInitOptions, MCPServer } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,GACtB,IAAI,CAkBN;AAED;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,IAAI,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/sdk/index.js

@@ -1 +1,80 @@
-import{NodeSDK as e}from"@opentelemetry/sdk-node";import{OTLPTraceExporter as r}from"@opentelemetry/exporter-trace-otlp-http";import{Resource as t}from"@opentelemetry/resources";import{trace as o,SpanStatusCode as n}from"@opentelemetry/api";const s="https://aware.mcypher.com/v1/traces",c="1.0.0";let i=null,a=null,l=!1;function u(){return a}async function g(){if(i)try{await i.shutdown(),i=null,a=null,l=!1}catch(e){console.error("[MCP Logger] Error shutting down telemetry:",e)}}function m(e,r){for(const[t,o]of Object.entries(r))null!=o&&e.setAttribute(t,o)}function p(e,r,t,o){try{t?e.addEvent(r,t):e.addEvent(r)}catch(e){o&&console.error("[MCP Logger] Failed to add span event:",e)}}function d(e,r=1e4){try{const t=JSON.stringify(e);return t.length>r?t.slice(0,r)+"... (truncated)":t}catch(e){return null}}function h(h,f){if(!f.apiKey)throw new Error("[MCP Logger SDK] apiKey is required");if(!h)throw new Error("[MCP Logger SDK] server instance is required");!function(n){if(l)return n.debug&&console.error("[MCP Logger] Telemetry already initialized, returning existing tracer"),a;const u=n.serviceName||`mcp-server-${Math.random().toString(36).slice(2,8)}`;n.debug&&(console.error("[MCP Logger] Initializing telemetry..."),console.error(`[MCP Logger] Endpoint: ${n.endpoint||s}`),console.error(`[MCP Logger] Service: ${u}`)),i=new e({resource:new t({"service.name":u,"service.version":c}),traceExporter:new r({url:n.endpoint||s,headers:{"x-api-key":n.apiKey}})}),i.start(),a=o.getTracer("mcp-logger",c),l=!0,n.debug&&console.error("[MCP Logger] Telemetry initialized successfully");const m=async()=>{n.debug&&console.error("[MCP Logger] Shutting down telemetry..."),await g()};process.once("SIGTERM",m),process.once("SIGINT",m)}(f),function(e,r=!1){const t=u();if(!t)throw new Error("[MCP Logger SDK] Tracer not initialized. Call initMCPLogger first.");const o=e.setRequestHandler.bind(e);e.setRequestHandler=function(e,s){const c=e.shape?.method,i=c?._def?.value||"unknown";return r&&console.log(`[MCP Logger SDK] Instrumenting handler: ${i}`),o(e,async(e,o)=>{const c=`mcp.${i}`;return await t.startActiveSpan(c,{attributes:{"mcp.method":i,"mcp.request.method":e.method}},async t=>{const c=Date.now();try{const i=d(e.params||{});m(t,{"mcp.request.id":"unknown","mcp.request.params.size":i?.length}),i&&i.length<1e3&&t.setAttribute("mcp.request.params",i),p(t,"mcp.request.received",{"request.method":e.method,"request.timestamp":c},r),r&&console.log("[MCP Logger SDK] Request received:",{method:e.method,params:e.params});const a=await s(e,o),l=Date.now(),u=l-c,g=d(a);return m(t,{"mcp.duration_ms":u,"mcp.response.size":g?.length}),g&&g.length<1e3&&t.setAttribute("mcp.response.result",g),p(t,"mcp.response.sent",{"response.timestamp":l,"response.duration_ms":u},r),function(e){e.setStatus({code:n.OK})}(t),r&&console.log(`[MCP Logger SDK] Response sent (${u}ms):`,a),a}catch(e){throw function(e,r,t){const o=r instanceof Error?r.message:"Unknown error",s=r instanceof Error?r.constructor.name:"Error";r instanceof Error&&e.recordException(r),e.setStatus({code:n.ERROR,message:o}),e.setAttribute("error",!0),e.setAttribute("error.type",s),e.setAttribute("error.message",o),t&&console.error("[MCP Logger] Error recorded in span:",r)}(t,e,r),r&&console.error("[MCP Logger SDK] Error occurred:",e),e}finally{t.end()}})})},r&&console.log("[MCP Logger SDK] Server instrumentation complete")}(h,f.debug),f.debug&&console.log("[MCP Logger SDK] ✓ Initialization complete")}export{h as initMCPLogger,g as shutdown};
+/**
+ * MCP Logger SDK
+ *
+ * MCP 서버에 자동 관측성(Observability)을 추가하는 SDK입니다.
+ */
+import { initializeTelemetry } from '../shared/telemetry.js';
+import { instrumentMCPServer } from './instrumentation.js';
+/**
+ * MCP 서버에 자동 계측을 추가합니다.
+ *
+ * 이 함수는 MCP 서버의 모든 요청/응답을 자동으로 로깅하고 추적합니다.
+ * OpenTelemetry를 사용하여 traces를 수집하며, 설정된 엔드포인트로 전송합니다.
+ *
+ * @param server - MCP Server 인스턴스
+ * @param options - 초기화 옵션
+ *
+ * @throws {Error} apiKey가 제공되지 않은 경우
+ * @throws {Error} server 인스턴스가 제공되지 않은 경우
+ *
+ * @example
+ * TypeScript 사용 예시:
+ * ```typescript
+ * import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+ * import { initMCPLogger } from '@awarecorp/mcp-logger';
+ *
+ * const server = new Server({ name: 'my-server', version: '1.0.0' }, {
+ *   capabilities: { tools: {} }
+ * });
+ *
+ * initMCPLogger(server, {
+ *   apiKey: 'your-api-key',
+ *   serviceName: 'my-mcp-server',
+ *   debug: true,
+ * });
+ *
+ * server.setRequestHandler('tools/call', async (request) => {
+ *   // 이 핸들러는 자동으로 로깅됩니다
+ *   return { result: 'success' };
+ * });
+ * ```
+ *
+ * @example
+ * JavaScript 사용 예시:
+ * ```javascript
+ * const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
+ * const { initMCPLogger } = require('@awarecorp/mcp-logger');
+ *
+ * const server = new Server({ name: 'my-server', version: '1.0.0' }, {
+ *   capabilities: { tools: {} }
+ * });
+ *
+ * initMCPLogger(server, {
+ *   apiKey: process.env.API_KEY,
+ *   serviceName: 'my-mcp-server',
+ * });
+ * ```
+ */
+export function initMCPLogger(server, options) {
+    if (!options.apiKey) {
+        throw new Error('[MCP Logger SDK] apiKey is required');
+    }
+    if (!server) {
+        throw new Error('[MCP Logger SDK] server instance is required');
+    }
+    // 1. OpenTelemetry SDK 초기화
+    initializeTelemetry(options);
+    // 2. MCP Server 계측
+    instrumentMCPServer(server, options.debug);
+    if (options.debug) {
+        console.log('[MCP Logger SDK] ✓ Initialization complete');
+    }
+}
+/**
+ * SDK를 종료하고 모든 pending traces를 flush합니다.
+ *
+ * 일반적으로 명시적으로 호출할 필요는 없습니다.
+ * 프로세스 종료 시 자동으로 처리됩니다.
+ */
+export { shutdownTelemetry as shutdown } from '../shared/telemetry.js';
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAqB,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAiB,EACjB,OAAuB;IAEvB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,2BAA2B;IAC3B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE7B,mBAAmB;IACnB,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAE3C,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,IAAI,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/sdk/instrumentation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP Server 자동 계측
+ *
+ * setRequestHandler를 오버라이드하여 모든 요청/응답을 자동으로 추적합니다.
+ */
+import type { MCPServer } from './types.js';
+/**
+ * MCP Server에 자동 계측 적용
+ */
+export declare function instrumentMCPServer(server: MCPServer, debug?: boolean): void;
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/sdk/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/sdk/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EACV,SAAS,EAKV,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,GAAE,OAAe,GAAG,IAAI,CAsHnF"}