@awarecorp/mcp-logger 0.0.2-dev.3 → 0.0.2

package/README.md

@@ -1,20 +1,26 @@
 # @awarecorp/mcp-logger
 
-**통합 MCP Observability 솔루션** - 하나의 패키지로 SDK와 CLI를 모두 제공합니다.
+**Unified MCP Observability Solution** - Monitor your Model Context Protocol servers with zero configuration.
+
+[![npm version](https://img.shields.io/npm/v/@awarecorp/mcp-logger)](https://www.npmjs.com/package/@awarecorp/mcp-logger)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[Aware Corp](https://awarecorp.io/)
 
 ---
 
-## 🎯 두 가지 사용 방법
+## 🎯 Overview
+
+`@awarecorp/mcp-logger` provides comprehensive observability for MCP servers in two ways:
 
-### 1️⃣ **SDK**: 코드에 직접 통합
-당신이 MCP 서버를 개발하고 있다면, SDK를 사용하세요.
+- **SDK**: Direct integration for custom MCP servers
+- **CLI**: Zero-code wrapper for existing MCP packages
 
-### 2️⃣ **CLI**: 코드 수정 없이 래핑
-이미 만들어진 MCP 서버(npm 패키지)를 사용한다면, CLI를 사용하세요.
+All telemetry data is sent to OpenTelemetry-compatible endpoints with automatic request-response pairing.
 
 ---
 
-## 📦 설치
+## 📦 Installation
 
 ```bash
 npm install @awarecorp/mcp-logger
@@ -22,296 +28,197 @@ npm install @awarecorp/mcp-logger
 
 ---
 
-## 1️⃣ SDK 사용법
+## 🚀 Quick Start
 
-### TypeScript
+### SDK Mode
+
+Instrument your MCP server with one line of code:
 
 ```typescript
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { initMCPLogger } from '@awarecorp/mcp-logger';
-
-const server = new Server(
-  { name: 'my-server', version: '1.0.0' },
-  { capabilities: { tools: {} } }
-);
-
-// 🔥 자동 계측 활성화 (이것만 추가하면 됩니다!)
-initMCPLogger(server, {
-  apiKey: process.env.AWARE_API_KEY!,
-  serviceName: 'my-awesome-mcp-server',
-  debug: true, // 디버그 로그 활성화 (선택사항)
-});
+import { trace } from '@awarecorp/mcp-logger';
 
-// 평소처럼 핸들러 등록
-server.setRequestHandler('tools/list', async () => ({
-  tools: [
-    { name: 'read_file', description: 'Read a file' },
-    { name: 'write_file', description: 'Write to a file' },
-  ],
-}));
-
-server.setRequestHandler('tools/call', async (request) => {
-  const { name, arguments: args } = request.params;
-  // 이 핸들러는 자동으로 로깅됩니다!
-  return { result: `Called ${name}` };
+trace(server, {
+  apiKey: 'YOUR_API_KEY',
+  serviceName: 'my-mcp-server'
 });
+```
 
-// stdio transport 시작
-const transport = new StdioServerTransport();
-await server.connect(transport);
+### CLI Mode
+
+Wrap any existing MCP server without code changes:
+
+```bash
+npx @awarecorp/mcp-logger \
+  -k YOUR_API_KEY \
+  -s my-server \
+  npx your-mcp-server
 ```
 
-### JavaScript (CommonJS)
+---
 
-```javascript
-const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
-const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
-const { initMCPLogger } = require('@awarecorp/mcp-logger');
+## 📋 Features
 
-const server = new Server(
-  { name: 'my-server', version: '1.0.0' },
-  { capabilities: { tools: {} } }
-);
+### Core Capabilities
 
-// 🔥 자동 계측 활성화
-initMCPLogger(server, {
-  apiKey: process.env.AWARE_API_KEY,
-  serviceName: 'my-mcp-server',
-});
+- **Automatic Request-Response Pairing**: Single span per request-response cycle
+- **Selective Method Tracking**: Only tracks `tools/call` and `tools/list` for efficiency
+- **Custom Event Logging**: Add context-aware logs within request handlers
+- **Transport Support**: stdio and SSE (Server-Sent Events)
+- **Zero Configuration**: Works out of the box with sensible defaults
 
-server.setRequestHandler('tools/list', async () => ({
-  tools: [{ name: 'test', description: 'Test tool' }],
-}));
+### Telemetry Data
 
-const transport = new StdioServerTransport();
-server.connect(transport);
-```
+All spans include:
+
+- Request/response timestamps and payloads
+- Method name and parameters
+- Tool names and arguments (for `tools/call`)
+- Custom events and logs
+- Error details (if any)
+- Duration metrics
+- CLI server information (command, args, env)
+
+### Data Format
+
+Optimized for Elasticsearch with flat structure:
+- `mcp.method`: Method name
+- `mcp.source`: `sdk` or `cli`
+- `mcp.transport`: `stdio` or `sse`
+- `mcp.duration_ms`: Request duration
+- `mcp.tool.name`: Tool name (tools/call only)
+- `mcp.events`: Custom log entries (JSON array)
+- `mcp.cli.server`: CLI execution info (JSON object)
 
-### SDK API
+---
+
+## 🔧 SDK API
 
-#### `initMCPLogger(server, options)`
+### `trace(server, options)`
 
-MCP 서버에 자동 계측을 추가합니다.
+Enable automatic instrumentation on an MCP server.
 
 **Parameters:**
-- `server` (`MCPServer`): MCP Server 인스턴스
-- `options` (`SDKInitOptions`):
-  - `apiKey` (string, 필수): Aware API 키
-  - `serviceName` (string, 옵션): 서비스 이름 (기본값: 자동 생성)
-  - `debug` (boolean, 옵션): 디버그 로그 활성화 (기본값: false)
-  - `endpoint` (string, 옵션): 커스텀 OTLP 엔드포인트
+- `server`: MCP Server instance
+- `options.apiKey`: API key for authentication (required)
+- `options.serviceName`: Service identifier (optional, auto-generated if omitted)
+- `options.endpoint`: Custom OTLP endpoint (optional)
+- `options.debug`: Enable debug logging (optional, default: false)
 
 **Returns:** `void`
 
-**Throws:**
-- `Error`: apiKey가 제공되지 않은 경우
-- `Error`: server 인스턴스가 제공되지 않은 경우
+### `trace.addLog(entry)`
 
----
+Add custom log entries within request handlers.
 
-## 2️⃣ CLI 사용법
+**Parameters:**
+- `entry.level`: Log level (`info` | `warn` | `error`)
+- `entry.message`: Log message (required)
+- `entry.metadata`: Additional data (optional)
+- `entry.timestamp`: Unix timestamp in milliseconds (optional, auto-generated)
 
-### 기본 사용법
+**Returns:** `void`
 
-```bash
-npx @awarecorp/mcp-logger \
-  --api-key YOUR_API_KEY \
-  -- \
-  npx @modelcontextprotocol/server-filesystem /path/to/dir
-```
+### `trace.shutdown()`
 
-`--` 뒤에 원래 사용하던 MCP 서버 명령어를 그대로 입력하면 됩니다.
+Gracefully shutdown telemetry and flush pending data.
 
-### 전역 설치 (선택사항)
+**Returns:** `Promise<void>`
 
-```bash
-npm install -g @awarecorp/mcp-logger
-```
+---
+
+## 🖥️ CLI Usage
+
+### Basic Syntax
 
-사용:
 ```bash
-mcp-logger --api-key YOUR_KEY -- npx server-filesystem /path
+mcp-logger [options] <command...>
 ```
 
-### Claude Desktop 설정
+### Options
 
-#### Before (관측성 없음)
-```json
-{
-  "mcpServers": {
-    "filesystem": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
-    }
-  }
-}
+- `-k, --api-key <key>`: API key (required)
+- `-s, --service-name <name>`: Service name (optional)
+- `-e, --endpoint <url>`: Custom OTLP endpoint (optional)
+
+### Examples
+
+**Wrap an npx command:**
+```bash
+mcp-logger -k API_KEY -s filesystem npx -y @modelcontextprotocol/server-filesystem /path
 ```
 
-#### After (관측성 추가) ✨
+**Use with Claude Desktop:**
 ```json
 {
   "mcpServers": {
-    "filesystem": {
+    "my-server": {
       "command": "npx",
       "args": [
         "-y",
         "@awarecorp/mcp-logger",
-        "--api-key", "your-aware-api-key",
-        "--service-name", "my-filesystem-server",
+        "-k",
+        "YOUR_API_KEY",
+        "-s",
+        "my-server",
         "--",
-        "@modelcontextprotocol/server-filesystem",
-        "/Users/username/Documents"
+        "npx",
+        "-y",
+        "your-mcp-server"
       ]
     }
   }
 }
 ```
 
-**이게 전부입니다!** 코드 수정 없이 모든 요청/응답이 Aware 플랫폼에 기록됩니다.
-
-### CLI 옵션
-
-#### 필수 옵션
-- `--api-key <key>` 또는 `-k <key>`: Aware API 키 (필수)
-
-#### 선택 옵션
-- `--service-name <name>` 또는 `-s <name>`: 서비스 식별 이름 (기본값: 자동 생성)
-- `--debug` 또는 `-d`: 디버그 로그 활성화
-- `--endpoint <url>` 또는 `-e <url>`: 커스텀 OTLP 엔드포인트
-
-### CLI 사용 예시
-
-#### 파일시스템 서버
-```bash
-npx @awarecorp/mcp-logger \
-  --api-key abc123 \
-  --service-name my-filesystem \
-  -- \
-  npx -y @modelcontextprotocol/server-filesystem /Users/username/Documents
-```
-
-#### GitHub 서버
-```bash
-npx @awarecorp/mcp-logger \
-  -k abc123 \
-  -s github-integration \
-  -- \
-  npx -y @modelcontextprotocol/server-github
-```
-
-#### Brave Search 서버 (디버그 모드)
-```bash
-npx @awarecorp/mcp-logger \
-  --api-key abc123 \
-  --service-name brave-search \
-  --debug \
-  -- \
-  npx -y @modelcontextprotocol/server-brave-search
-```
-
 ---
 
-## 🏗️ 아키텍처
+## 🏗️ How It Works
 
-이 패키지는 세 가지 레이어로 구성되어 있습니다:
+### Request-Response Pairing
 
-```
-@awarecorp/mcp-logger
-├── SDK (공개 API)
-│   ├── initMCPLogger()    - MCP 서버 계측
-│   └── shutdown()          - 텔레메트리 종료
-│
-├── CLI (바이너리만 접근 가능)
-│   └── mcp-logger          - CLI 래퍼
-│
-└── Shared (내부 구현)
-    ├── telemetry           - OpenTelemetry 초기화
-    ├── span-utils          - Span 유틸리티
-    └── config              - 공통 설정
-```
+Creates **one span per request-response pair** for complete transaction context:
 
-### 중요한 설계 원칙
+1. Request arrives → stored in pending map
+2. Response arrives → matched by ID, single span created
+3. Timeout (30s) → pending requests cleared
 
-1. **SDK만 공개 API로 노출**: `import`로는 SDK만 접근 가능
-2. **CLI는 바이너리로만 접근**: `npx` 또는 `mcp-logger` 명령어로만 사용
-3. **공통 코드 재사용**: OpenTelemetry 로직은 shared 레이어에서 통합 관리
-4. **타입 안전성**: CLI는 타입 정의가 노출되지 않음
+### Tracked Methods
 
----
+Only tracks business-critical methods:
+- `tools/call` - Tool executions
+- `tools/list` - Tool discovery
 
-## 🔧 개발
-
-### 빌드
-
-```bash
-npm run build
-```
-
-### 로컬 테스트
-
-#### SDK 테스트
-```typescript
-// test.ts
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { initMCPLogger } from './src/index.js';
-
-const server = new Server({ name: 'test', version: '1.0.0' }, { capabilities: {} });
-initMCPLogger(server, { apiKey: 'test', debug: true });
-```
-
-#### CLI 테스트
-```bash
-npm run build
-node bin/mcp-logger.js --help
-```
+Protocol methods (`initialize`, `ping`, etc.) are ignored.
 
 ---
 
-## 📝 라이선스
+## 📊 Telemetry Data Structure
 
-MIT
+Each span includes:
+- Request/response timestamps and payloads
+- Method name and parameters  
+- Tool names and arguments (for `tools/call`)
+- Custom events and logs
+- Error details and duration metrics
+- CLI server information (command, args, env)
 
 ---
 
-## 🤝 기여
+## 🤝 Contributing
 
-이슈와 PR은 언제나 환영합니다!
-
-자세한 개발 가이드는 [DEVELOPMENT.md](./DEVELOPMENT.md)를 참조하세요.
+For development setup and guidelines, visit [GitHub Repository](https://github.com/awarecorp/mcp-logger).
 
 ---
 
-## 📦 배포 (Maintainers Only)
-
-**권장:** GitHub Actions를 사용한 자동 배포
-
-### 자동 배포 (GitHub Actions) ⭐
-```bash
-# Dev 버전 (develop 브랜치)
-git checkout develop
-npm run version:dev
-git push origin develop --tags
-```
-
-자세한 가이드:
-- [GITHUB_SETUP.md](./GITHUB_SETUP.md) - Repository 초기 설정
-- [GITHUB_ACTIONS.md](./GITHUB_ACTIONS.md) - 자동 배포 사용법
-
-### 수동 배포 (로컬)
-```bash
-# Dev 버전
-npm run version:dev
-npm run publish:dev
-```
-
-**참고:** Stable 버전은 아직 지원하지 않습니다.
+## 📄 License
 
-자세한 개발 가이드: [DEVELOPMENT.md](./DEVELOPMENT.md)
+MIT © [Aware Corp](https://awarecorp.io/)
 
 ---
 
-## 📞 지원
+## 🔗 Links
 
-- 문서: [https://aware.mcypher.com/docs](https://aware.mcypher.com/docs)
-- 이슈: [GitHub Issues](https://github.com/your-org/mcp-logger/issues)
+- [Aware Corp](https://awarecorp.io/)
+- [npm Package](https://www.npmjs.com/package/@awarecorp/mcp-logger)
+- [GitHub Repository](https://github.com/awarecorp/mcp-logger)
+- [Model Context Protocol](https://modelcontextprotocol.io/)

package/bin/mcp-logger.js

@@ -6,4 +6,4 @@
  * 컴파일된 CLI를 실행합니다.
  */
 
-import '../dist/cli/cli.js';
+import '../dist/cli/main.js';

package/dist/cli/interceptor.js

@@ -1 +1 @@
-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};
+import{Transform as e}from"stream";class s extends e{buffer="";direction;pairer;debug;constructor(e,s,r=!1){super(),this.direction=e,this.pairer=s,this.debug=r}_transform(e,s,r){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(),r()}catch(e){r(e)}}tryParseMessages(){const e=this.buffer.split("\n");this.buffer=e.pop()||"";for(const s of e){const e=s.trim();if(e)try{const s=JSON.parse(e);this.handleMessage(s)}catch(s){this.debug&&console.error("[mcp-logger CLI] Failed to parse:",e.slice(0,100))}}}handleMessage(e){"request"===this.direction&&e.method?this.pairer.onRequest(e):"response"!==this.direction||void 0===e.id||e.method||this.pairer.onResponse(e)}_flush(e){try{if(this.buffer.trim())try{const e=JSON.parse(this.buffer);this.handleMessage(e)}catch(e){this.debug&&console.error("[mcp-logger CLI] Failed to parse final buffer")}if(this.debug){const e=this.pairer.getStats();console.error("[mcp-logger CLI] Stream closed. Pending requests: "+e.pending)}e()}catch(s){e(s)}}}export{s as MessageInterceptor};

package/dist/cli/main.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+function e(){return h}function r(){return I}async function t(){if(d)try{await d.shutdown(),d=null,h=null,f=!1,I=null}catch(e){console.error("[MCP Logger] Error shutting down telemetry:",e)}}function s(e,r=1e4){try{const t=JSON.stringify(e);return t.length>r?t.slice(0,r)+"... (truncated)":t}catch(e){return null}}function o(t){const o=e();if(!o)return void console.error("[MCP Logger] Tracer not initialized, cannot create span");const n="mcp."+t.method;o.startActiveSpan(n,e=>{try{const o={"mcp.method":t.method,"mcp.source":t.source,"mcp.transport":t.transport,"mcp.log_type":"request-response","mcp.request.id":t.request.id+"","mcp.request.timestamp":t.request.timestamp,"mcp.request.params":s(t.request.params)||"{}","mcp.request.params.size":JSON.stringify(t.request.params||{}).length,"mcp.response.timestamp":t.response.timestamp,"mcp.duration_ms":t.duration};if("tools/call"===t.method&&t.request.params){const e=t.request.params.name,r=t.request.params.arguments;if(e&&(o["mcp.tool.name"]=e),r){const e=s(r);e&&(o["mcp.tool.arguments"]=e,o["mcp.tool.arguments.size"]=JSON.stringify(r).length)}}if(void 0!==t.response.result){const e=s(t.response.result);e&&(o["mcp.response.result"]=e,o["mcp.response.result.size"]=JSON.stringify(t.response.result).length)}if(t.request.headers){const e=s(t.request.headers);e&&(o["mcp.headers"]=e,o["mcp.headers.size"]=JSON.stringify(t.request.headers).length)}if("cli"===t.source){const e=r();e&&(o["mcp.cli.server"]=JSON.stringify({command:e.command,args:e.args,env:e.env}))}if(t.customEvents&&t.customEvents.length>0&&(o["mcp.events"]=JSON.stringify(t.customEvents),o["mcp.events.count"]=t.customEvents.length,t.customEvents.forEach(r=>{e.addEvent("custom."+(r.level||"info"),{message:r.message,metadata:JSON.stringify(r.metadata||{}),timestamp:r.timestamp||Date.now()})})),t.response.error){o["mcp.error"]=!0;const r=t.response.error instanceof Error?t.response.error.message:t.response.error+"";o["mcp.error.message"]=r,t.response.error instanceof Error&&e.recordException(t.response.error),e.setStatus({code:u.ERROR,message:r})}else e.setStatus({code:u.OK});!function(e,r){for(const[t,s]of Object.entries(r))null!=s&&e.setAttribute(t,s)}(e,o)}catch(r){console.error("[MCP Logger] Error creating paired span:",r),e.setStatus({code:u.ERROR,message:r+""})}finally{e.end()}})}import{spawn as n}from"child_process";import{program as i}from"commander";import{NodeSDK as c}from"@opentelemetry/sdk-node";import{OTLPTraceExporter as a}from"@opentelemetry/exporter-trace-otlp-http";import{Resource as p}from"@opentelemetry/resources";import{trace as m,SpanStatusCode as u}from"@opentelemetry/api";import{Transform as l}from"stream";const g={ENDPOINT:"https://aware.mcypher.com/v1/traces",SDK_VERSION:"1.0.0",SERVICE_NAME_PREFIX:"mcp-server",TRACKED_METHODS:["tools/call","tools/list"]};let d=null,h=null,f=!1,I=null;class y extends l{buffer="";direction;pairer;debug;constructor(e,r,t=!1){super(),this.direction=e,this.pairer=r,this.debug=t}_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.handleMessage(r)}catch(r){this.debug&&console.error("[mcp-logger CLI] Failed to parse:",e.slice(0,100))}}}handleMessage(e){"request"===this.direction&&e.method?this.pairer.onRequest(e):"response"!==this.direction||void 0===e.id||e.method||this.pairer.onResponse(e)}_flush(e){try{if(this.buffer.trim())try{const e=JSON.parse(this.buffer);this.handleMessage(e)}catch(e){this.debug&&console.error("[mcp-logger CLI] Failed to parse final buffer")}if(this.debug){const e=this.pairer.getStats();console.error("[mcp-logger CLI] Stream closed. Pending requests: "+e.pending)}e()}catch(r){e(r)}}}class S{pendingRequests=new Map;debug;TIMEOUT=3e4;constructor(e=!1){this.debug=e}onRequest(e){var r;r=e.method,g.TRACKED_METHODS.includes(r)?e.id?(this.pendingRequests.set(e.id,{request:e,timestamp:Date.now()}),this.debug&&console.error(`[mcp-logger CLI] Request stored: ${e.method} (ID: ${e.id})`),setTimeout(()=>this.cleanupStale(e.id),this.TIMEOUT)):this.debug&&console.error("[mcp-logger CLI] Request without ID, skipping:",e.method):this.debug&&console.error("[mcp-logger CLI] Skipping method: "+e.method)}onResponse(e){if(!e.id)return void(this.debug&&console.error("[mcp-logger CLI] Response without ID, skipping"));const r=this.pendingRequests.get(e.id);if(!r)return void(this.debug&&console.error("[mcp-logger CLI] No matching request for response ID: "+e.id));const t=Date.now(),s=t-r.timestamp;this.debug&&console.error(`[mcp-logger CLI] Pairing success: ${r.request.method} (${s}ms)`),this.createPairedSpan(r.request,e,r.timestamp,t,s),this.pendingRequests.delete(e.id)}createPairedSpan(e,r,t,s,n){o({method:e.method,source:"cli",transport:"stdio",request:{id:e.id,timestamp:t,params:e.params},response:{timestamp:s,result:r.result,error:r.error},duration:n})}cleanupStale(e){const r=this.pendingRequests.get(e);r&&Date.now()-r.timestamp>this.TIMEOUT&&(this.debug&&console.error(`[mcp-logger CLI] Request timeout: ${r.request.method} (ID: ${e})`),this.pendingRequests.delete(e))}getStats(){return{pending:this.pendingRequests.size}}clear(){this.debug&&console.error(`[mcp-logger CLI] Clearing ${this.pendingRequests.size} pending requests`),this.pendingRequests.clear()}}i.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("-e, --endpoint <url>","Custom OTLP endpoint").argument("<command...>","MCP server command to wrap").action(async(e,r)=>{try{const s=!0;!function(e){if(f)return console.error("[MCP Logger] Telemetry already initialized, returning existing tracer"),h;const r=e.serviceName||`${g.SERVICE_NAME_PREFIX}-${Math.random().toString(36).slice(2,8)}`;console.error("[MCP Logger] Initializing telemetry..."),console.error("[MCP Logger] Endpoint: "+(e.endpoint||g.ENDPOINT)),console.error("[MCP Logger] Service: "+r),d=new c({resource:new p({"service.name":r,"service.version":g.SDK_VERSION}),traceExporter:new a({url:e.endpoint||g.ENDPOINT,headers:{"x-api-key":e.apiKey}})}),d.start(),h=m.getTracer("mcp-logger",g.SDK_VERSION),f=!0,console.error("[MCP Logger] Telemetry initialized successfully");const s=async()=>{console.error("[MCP Logger] Shutting down telemetry..."),await t()};process.once("SIGTERM",s),process.once("SIGINT",s)}({...r,debug:s}),console.error("[MCP Logger CLI] Starting MCP server:",e.join(" "));const[o,...i]=e;!function(e,r,t){I={command:e,args:r,env:t}}(o,i,{...process.env});const u=n(o,i,{stdio:["pipe","pipe","inherit"],env:{...process.env,MCP_LOGGER_ENABLED:"true"}}),l=new S(s),C=new y("request",l,s);process.stdin.pipe(C).pipe(u.stdin);const E=new y("response",l,s);u.stdout.pipe(E).pipe(process.stdout),u.on("error",async e=>{console.error("[MCP Logger CLI] Failed to start MCP server:",e),l.clear(),await t(),process.exit(1)}),u.on("exit",async(e,r)=>{console.error(`[MCP Logger CLI] MCP server exited with code ${e}, signal ${r}`),l.clear(),await t(),process.exit(e||0)});let q=!1;const v=async e=>{q||(q=!0,console.error(`[MCP Logger CLI] Received ${e}, shutting down...`),u.kill(e),await Promise.race([new Promise(e=>u.once("exit",e)),new Promise(e=>setTimeout(e,5e3))]),await t(),process.exit(0))};process.on("SIGTERM",()=>v("SIGTERM")),process.on("SIGINT",()=>v("SIGINT"))}catch(e){console.error("[MCP Logger CLI] Fatal error:",e),await t(),process.exit(1)}}),i.parse();

package/dist/cli/pairing.js

@@ -0,0 +1 @@
+import"@opentelemetry/api";import"@opentelemetry/sdk-node";import"@opentelemetry/exporter-trace-otlp-http";import"@opentelemetry/resources";const e={TRACKED_METHODS:["tools/call","tools/list"]};class t{pendingRequests=new Map;debug;TIMEOUT=3e4;constructor(e=!1){this.debug=e}onRequest(t){var s;s=t.method,e.TRACKED_METHODS.includes(s)?t.id?(this.pendingRequests.set(t.id,{request:t,timestamp:Date.now()}),this.debug&&console.error(`[mcp-logger CLI] Request stored: ${t.method} (ID: ${t.id})`),setTimeout(()=>this.cleanupStale(t.id),this.TIMEOUT)):this.debug&&console.error("[mcp-logger CLI] Request without ID, skipping:",t.method):this.debug&&console.error("[mcp-logger CLI] Skipping method: "+t.method)}onResponse(e){if(!e.id)return void(this.debug&&console.error("[mcp-logger CLI] Response without ID, skipping"));const t=this.pendingRequests.get(e.id);if(!t)return void(this.debug&&console.error("[mcp-logger CLI] No matching request for response ID: "+e.id));const s=Date.now(),o=s-t.timestamp;this.debug&&console.error(`[mcp-logger CLI] Pairing success: ${t.request.method} (${o}ms)`),this.createPairedSpan(t.request,e,t.timestamp,s,o),this.pendingRequests.delete(e.id)}createPairedSpan(e,t,s,o,r){e.method,e.id,e.params,t.result,t.error,console.error("[MCP Logger] Tracer not initialized, cannot create span")}cleanupStale(e){const t=this.pendingRequests.get(e);t&&Date.now()-t.timestamp>this.TIMEOUT&&(this.debug&&console.error(`[mcp-logger CLI] Request timeout: ${t.request.method} (ID: ${e})`),this.pendingRequests.delete(e))}getStats(){return{pending:this.pendingRequests.size}}clear(){this.debug&&console.error(`[mcp-logger CLI] Clearing ${this.pendingRequests.size} pending requests`),this.pendingRequests.clear()}}export{t as RequestResponsePairer};

package/dist/core/config.js

@@ -0,0 +1 @@
+function t(t){return E.TRACKED_METHODS.includes(t)}const E={ENDPOINT:"https://aware.mcypher.com/v1/traces",SDK_VERSION:"1.0.0",SERVICE_NAME_PREFIX:"mcp-server",TRACKED_METHODS:["tools/call","tools/list"]};export{E as CONFIG,t as shouldTrackMethod};

package/dist/core/span-builder.js

@@ -0,0 +1 @@
+function e(e){console.error("[MCP Logger] Tracer not initialized, cannot create span")}import"@opentelemetry/api";import"@opentelemetry/sdk-node";import"@opentelemetry/exporter-trace-otlp-http";import"@opentelemetry/resources";export{e as createPairedSpan};

package/dist/core/span-utils.js

@@ -0,0 +1 @@
+function t(t,r){for(const[e,n]of Object.entries(r))null!=n&&t.setAttribute(e,n)}function r(t,r,e,n){try{e?t.addEvent(r,e):t.addEvent(r)}catch(t){n&&console.error("[MCP Logger] Failed to add span event:",t)}}function e(t,r,e){const n=r instanceof Error?r.message:"Unknown error",o=r instanceof Error?r.constructor.name:"Error";r instanceof Error&&t.recordException(r),t.setStatus({code:s.ERROR,message:n}),t.setAttribute("error",!0),t.setAttribute("error.type",o),t.setAttribute("error.message",n),e&&console.error("[MCP Logger] Error recorded in span:",r)}function n(t){t.setStatus({code:s.OK})}function o(t,r=1e4){try{const e=JSON.stringify(t);return e.length>r?e.slice(0,r)+"... (truncated)":e}catch(t){return null}}function c(){const t={},r=a.active(),e=i.getSpan(r);if(e){const r=e.spanContext();r&&(t.traceparent=`00-${r.traceId}-${r.spanId}-01`)}return t}import{SpanStatusCode as s,context as a,trace as i}from"@opentelemetry/api";export{r as addSpanEvent,c as getTraceHeaders,n as markSpanSuccess,e as recordSpanError,o as safeStringify,t as setSpanAttributes};

package/dist/core/telemetry.js

@@ -0,0 +1 @@
+function e(e){if(y)return e.debug&&console.error("[MCP Logger] Telemetry already initialized, returning existing tracer"),d;const r=e.serviceName||`${m}-${Math.random().toString(36).slice(2,8)}`;e.debug&&(console.error("[MCP Logger] Initializing telemetry..."),console.error("[MCP Logger] Endpoint: "+(e.endpoint||u)),console.error("[MCP Logger] Service: "+r)),p=new c({resource:new s({"service.name":r,"service.version":g}),traceExporter:new l({url:e.endpoint||u,headers:{"x-api-key":e.apiKey}})}),p.start(),d=a.getTracer("mcp-logger",g),y=!0,e.debug&&console.error("[MCP Logger] Telemetry initialized successfully");const o=async()=>{e.debug&&console.error("[MCP Logger] Shutting down telemetry..."),await i()};return process.once("SIGTERM",o),process.once("SIGINT",o),d}function r(){return d}function o(){return y}function t(e,r,o){f={command:e,args:r,env:o}}function n(){return f}async function i(){if(p)try{await p.shutdown(),p=null,d=null,y=!1,f=null}catch(e){console.error("[MCP Logger] Error shutting down telemetry:",e)}}import{NodeSDK as c}from"@opentelemetry/sdk-node";import{OTLPTraceExporter as l}from"@opentelemetry/exporter-trace-otlp-http";import{Resource as s}from"@opentelemetry/resources";import{trace as a}from"@opentelemetry/api";const u="https://aware.mcypher.com/v1/traces",g="1.0.0",m="mcp-server";let p=null,d=null,y=!1,f=null;export{n as getCLIServerInfo,r as getTracer,e as initializeTelemetry,o as isInitializedTelemetry,t as setCLIServerInfo,i as shutdownTelemetry};

package/dist/core/types.d.ts

@@ -0,0 +1,174 @@
+/**
+ * 공통 설정 상수
+ */
+declare const CONFIG: {
+    /**
+     * OTLP Endpoint (하드코딩)
+     */
+    readonly ENDPOINT: "https://aware.mcypher.com/v1/traces";
+    /**
+     * SDK 버전
+     */
+    readonly SDK_VERSION: "1.0.0";
+    /**
+     * 서비스 이름 접두사
+     */
+    readonly SERVICE_NAME_PREFIX: "mcp-server";
+    /**
+     * 추적 대상 메서드
+     * CLI와 SDK 모두에서 공통으로 사용
+     */
+    readonly TRACKED_METHODS: readonly ["tools/call", "tools/list"];
+};
+/**
+ * 추적 대상 메서드 타입
+ */
+type TrackedMethod = typeof CONFIG.TRACKED_METHODS[number];
+
+/**
+ * 공통 타입 정의
+ */
+
+/**
+ * 텔레메트리 초기화 옵션
+ */
+interface TelemetryOptions {
+    /**
+     * API Key for authentication (필수)
+     */
+    apiKey: string;
+    /**
+     * 서비스 이름 (옵션)
+     * 지정하지 않으면 자동으로 'mcp-server-{random}' 형식으로 생성
+     */
+    serviceName?: string;
+    /**
+     * 커스텀 OTLP 엔드포인트 (옵션)
+     * 기본값: CONFIG.ENDPOINT
+     */
+    endpoint?: string;
+    /**
+     * 디버그 로그 활성화 (옵션)
+     */
+    debug?: boolean;
+}
+/**
+ * Span 속성 인터페이스
+ */
+interface SpanAttributes {
+    [key: string]: string | number | boolean | undefined;
+}
+/**
+ * MCP 메시지 방향
+ */
+type MessageDirection = 'request' | 'response';
+/**
+ * 로그 타입 분류
+ */
+type MCPLogType = 'request-response' | 'custom-event' | 'internal-event';
+/**
+ * JSON-RPC 메시지 타입
+ */
+interface JSONRPCMessage {
+    jsonrpc: '2.0';
+    id?: string | number;
+    method?: string;
+    params?: any;
+    result?: any;
+    error?: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+}
+/**
+ * JSON-RPC Request 타입
+ */
+interface JSONRPCRequest extends JSONRPCMessage {
+    method: string;
+    params?: any;
+}
+/**
+ * JSON-RPC Response 타입
+ */
+interface JSONRPCResponse extends JSONRPCMessage {
+    id: string | number;
+    result?: any;
+    error?: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+}
+/**
+ * MCP Span 데이터 구조 (ES 최적화)
+ */
+interface MCPSpanData {
+    'mcp.method': TrackedMethod;
+    'mcp.source': 'cli' | 'sdk';
+    'mcp.transport': 'stdio' | 'sse';
+    'mcp.log_type': MCPLogType;
+    'mcp.request.id': string;
+    'mcp.request.timestamp': number;
+    'mcp.request.params': string;
+    'mcp.request.params.size': number;
+    'mcp.response.timestamp': number;
+    'mcp.response.result'?: string;
+    'mcp.response.result.size'?: number;
+    'mcp.duration_ms': number;
+    'mcp.tool.name'?: string;
+    'mcp.tool.arguments'?: string;
+    'mcp.tool.arguments.size'?: number;
+    'mcp.headers'?: string;
+    'mcp.headers.size'?: number;
+    'mcp.events'?: string;
+    'mcp.events.count'?: number;
+    'mcp.cli.server'?: string;
+    'mcp.error'?: boolean;
+    'mcp.error.code'?: number;
+    'mcp.error.message'?: string;
+}
+/**
+ * 커스텀 로그 엔트리
+ */
+interface CustomLogEntry {
+    /**
+     * 로그 레벨
+     */
+    level?: 'info' | 'warn' | 'error';
+    /**
+     * 로그 메시지
+     */
+    message: string;
+    /**
+     * 추가 메타데이터 (자유 형식)
+     */
+    metadata?: Record<string, any>;
+    /**
+     * 타임스탬프 (자동 생성 가능)
+     */
+    timestamp?: number;
+}
+/**
+ * Paired Span 입력 데이터
+ */
+interface PairedSpanInput {
+    method: TrackedMethod;
+    source: 'cli' | 'sdk';
+    transport: 'stdio' | 'sse';
+    request: {
+        id: string | number;
+        timestamp: number;
+        params: any;
+        headers?: Record<string, string>;
+    };
+    response: {
+        timestamp: number;
+        result?: any;
+        error?: any;
+    };
+    duration: number;
+    customEvents?: CustomLogEntry[];
+}
+
+export type { CustomLogEntry, JSONRPCMessage, JSONRPCRequest, JSONRPCResponse, MCPLogType, MCPSpanData, MessageDirection, PairedSpanInput, SpanAttributes, TelemetryOptions };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 /**
  * 공통 타입 정의
  */
+
 /**
  * 텔레메트리 초기화 옵션
  */
@@ -26,32 +27,45 @@ interface TelemetryOptions {
      */
     debug?: boolean;
 }
+/**
+ * 커스텀 로그 엔트리
+ */
+interface CustomLogEntry$1 {
+    /**
+     * 로그 레벨
+     */
+    level?: 'info' | 'warn' | 'error';
+    /**
+     * 로그 메시지
+     */
+    message: string;
+    /**
+     * 추가 메타데이터 (자유 형식)
+     */
+    metadata?: Record<string, any>;
+    /**
+     * 타임스탬프 (자동 생성 가능)
+     */
+    timestamp?: number;
+}
 
 /**
  * SDK 타입 정의
  */
 
 /**
- * SDK 초기화 옵션 (TelemetryOptions 확장)
+ * Trace 옵션
  */
-interface SDKInitOptions extends TelemetryOptions {
+interface TraceOptions extends TelemetryOptions {
 }
 /**
- * MCP Server 타입 (재export)
- */
-type MCPServer = Server;
-
-/**
- * 공통 텔레메트리 레이어
- *
- * OpenTelemetry SDK 초기화 및 관리를 담당합니다.
- * SDK와 CLI 양쪽에서 공통으로 사용됩니다.
+ * Custom Log Entry (re-export from core)
  */
-
+type CustomLogEntry = CustomLogEntry$1;
 /**
- * Telemetry 종료
+ * MCP Server 타입 (재export)
  */
-declare function shutdownTelemetry(): Promise<void>;
+type MCPServer = Server;
 
 /**
  * MCP Logger SDK
@@ -60,56 +74,64 @@ declare function shutdownTelemetry(): Promise<void>;
  */
 
 /**
- * MCP 서버에 자동 계측을 추가합니다.
- *
- * 이 함수는 MCP 서버의 모든 요청/응답을 자동으로 로깅하고 추적합니다.
- * OpenTelemetry를 사용하여 traces를 수집하며, 설정된 엔드포인트로 전송합니다.
- *
- * @param server - MCP Server 인스턴스
- * @param options - 초기화 옵션
- *
- * @throws {Error} apiKey가 제공되지 않은 경우
- * @throws {Error} server 인스턴스가 제공되지 않은 경우
+ * trace 네임스페이스
  *
  * @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: {} }
- * });
+ * import { trace } from '@awarecorp/mcp-logger';
  *
- * initMCPLogger(server, {
+ * // 서버 계측
+ * trace(server, {
  *   apiKey: 'your-api-key',
- *   serviceName: 'my-mcp-server',
- *   debug: true,
+ *   serviceName: 'my-service',
  * });
  *
+ * // Handler 내부에서 커스텀 로그 추가
  * server.setRequestHandler('tools/call', async (request) => {
- *   // 이 핸들러는 자동으로 로깅됩니다
- *   return { result: 'success' };
- * });
- * ```
+ *   trace.addLog({
+ *     level: 'info',
+ *     message: 'Processing started',
+ *     metadata: { id: request.params.arguments.id },
+ *   });
  *
- * @example
- * JavaScript 사용 예시:
- * ```javascript
- * const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
- * const { initMCPLogger } = require('@awarecorp/mcp-logger');
+ *   const result = await process();
  *
- * const server = new Server({ name: 'my-server', version: '1.0.0' }, {
- *   capabilities: { tools: {} }
- * });
+ *   trace.addLog({
+ *     level: 'info',
+ *     message: 'Processing completed',
+ *     metadata: { duration: 100 },
+ *   });
  *
- * initMCPLogger(server, {
- *   apiKey: process.env.API_KEY,
- *   serviceName: 'my-mcp-server',
+ *   return result;
  * });
  * ```
  */
-declare function initMCPLogger(server: MCPServer, options: SDKInitOptions): void;
+declare const trace: ((server: MCPServer, options: TraceOptions) => void) & {
+    /**
+     * 현재 active span에 커스텀 로그 추가
+     *
+     * ⚠️ 주의: Request handler 내부에서만 호출해야 합니다.
+     *
+     * @param entry - 커스텀 로그 엔트리
+     *
+     * @example
+     * ```typescript
+     * trace.addLog({
+     *   level: 'info',
+     *   message: 'Database query executed',
+     *   metadata: { query: 'SELECT * FROM users', rows: 42 },
+     * });
+     * ```
+     */
+    addLog(entry: CustomLogEntry$1): void;
+    /**
+     * Telemetry 종료
+     *
+     * 일반적으로 명시적으로 호출할 필요는 없습니다.
+     * 프로세스 종료 시 자동으로 처리됩니다.
+     */
+    shutdown(): Promise<void>;
+};
 
-export { initMCPLogger, shutdownTelemetry as shutdown };
-export type { MCPServer, SDKInitOptions };
+export { trace };
+export type { CustomLogEntry, MCPServer, TraceOptions };

package/dist/index.js

@@ -1 +1 @@
-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};
+function e(){return g}function t(){return f}async function r(){if(u)try{await u.shutdown(),u=null,g=null,d=!1,f=null}catch(e){console.error("[MCP Logger] Error shutting down telemetry:",e)}}function s(e,t=1e4){try{const r=JSON.stringify(e);return r.length>t?r.slice(0,t)+"... (truncated)":r}catch(e){return null}}function o(r){const o=e();if(!o)return void console.error("[MCP Logger] Tracer not initialized, cannot create span");const n="mcp."+r.method;o.startActiveSpan(n,e=>{try{const o={"mcp.method":r.method,"mcp.source":r.source,"mcp.transport":r.transport,"mcp.log_type":"request-response","mcp.request.id":r.request.id+"","mcp.request.timestamp":r.request.timestamp,"mcp.request.params":s(r.request.params)||"{}","mcp.request.params.size":JSON.stringify(r.request.params||{}).length,"mcp.response.timestamp":r.response.timestamp,"mcp.duration_ms":r.duration};if("tools/call"===r.method&&r.request.params){const e=r.request.params.name,t=r.request.params.arguments;if(e&&(o["mcp.tool.name"]=e),t){const e=s(t);e&&(o["mcp.tool.arguments"]=e,o["mcp.tool.arguments.size"]=JSON.stringify(t).length)}}if(void 0!==r.response.result){const e=s(r.response.result);e&&(o["mcp.response.result"]=e,o["mcp.response.result.size"]=JSON.stringify(r.response.result).length)}if(r.request.headers){const e=s(r.request.headers);e&&(o["mcp.headers"]=e,o["mcp.headers.size"]=JSON.stringify(r.request.headers).length)}if("cli"===r.source){const e=t();e&&(o["mcp.cli.server"]=JSON.stringify({command:e.command,args:e.args,env:e.env}))}if(r.customEvents&&r.customEvents.length>0&&(o["mcp.events"]=JSON.stringify(r.customEvents),o["mcp.events.count"]=r.customEvents.length,r.customEvents.forEach(t=>{e.addEvent("custom."+(t.level||"info"),{message:t.message,metadata:JSON.stringify(t.metadata||{}),timestamp:t.timestamp||Date.now()})})),r.response.error){o["mcp.error"]=!0;const t=r.response.error instanceof Error?r.response.error.message:r.response.error+"";o["mcp.error.message"]=t,r.response.error instanceof Error&&e.recordException(r.response.error),e.setStatus({code:a.ERROR,message:t})}else e.setStatus({code:a.OK});!function(e,t){for(const[r,s]of Object.entries(t))null!=s&&e.setAttribute(r,s)}(e,o)}catch(t){console.error("[MCP Logger] Error creating paired span:",t),e.setStatus({code:a.ERROR,message:t+""})}finally{e.end()}})}import{trace as n,SpanStatusCode as a,context as c}from"@opentelemetry/api";import{NodeSDK as i}from"@opentelemetry/sdk-node";import{OTLPTraceExporter as m}from"@opentelemetry/exporter-trace-otlp-http";import{Resource as l}from"@opentelemetry/resources";const p={ENDPOINT:"https://aware.mcypher.com/v1/traces",SDK_VERSION:"1.0.0",SERVICE_NAME_PREFIX:"mcp-server",TRACKED_METHODS:["tools/call","tools/list"]};let u=null,g=null,d=!1,f=null;const h=Symbol("mcp-logger.customEvents"),E=Object.assign(function(e,t){if(!t.apiKey)throw Error("[mcp-logger] apiKey is required");if(!e)throw Error("[mcp-logger] server instance is required");!function(e){if(d)return e.debug&&console.error("[MCP Logger] Telemetry already initialized, returning existing tracer"),g;const t=e.serviceName||`${p.SERVICE_NAME_PREFIX}-${Math.random().toString(36).slice(2,8)}`;e.debug&&(console.error("[MCP Logger] Initializing telemetry..."),console.error("[MCP Logger] Endpoint: "+(e.endpoint||p.ENDPOINT)),console.error("[MCP Logger] Service: "+t)),u=new i({resource:new l({"service.name":t,"service.version":p.SDK_VERSION}),traceExporter:new m({url:e.endpoint||p.ENDPOINT,headers:{"x-api-key":e.apiKey}})}),u.start(),g=n.getTracer("mcp-logger",p.SDK_VERSION),d=!0,e.debug&&console.error("[MCP Logger] Telemetry initialized successfully");const s=async()=>{e.debug&&console.error("[MCP Logger] Shutting down telemetry..."),await r()};process.once("SIGTERM",s),process.once("SIGINT",s)}(t),function(e,t){const r=e.setRequestHandler.bind(e);e.setRequestHandler=function(e,s){const n=e.shape?.method,a=n?._def?.value||"unknown";return function(e){return p.TRACKED_METHODS.includes(e)}(a)?(t.debug&&console.log("[mcp-logger] Instrumenting handler: "+a),r(e,async(e,r)=>{const n=Date.now(),i=`${a}-${n}-${Math.random().toString(36).slice(2,8)}`,m=[],l=c.active().setValue(h,m);try{const p=await c.with(l,async()=>await s(e,r)),u=Date.now();return o({method:a,source:"sdk",transport:"stdio",request:{id:i,timestamp:n,params:e.params},response:{timestamp:u,result:p},duration:u-n,customEvents:m.length>0?m:void 0}),t.debug&&console.log(`[mcp-logger] Request completed (${u-n}ms):`,{method:a,customEvents:m.length}),p}catch(r){const s=Date.now();throw o({method:a,source:"sdk",transport:"stdio",request:{id:i,timestamp:n,params:e.params},response:{timestamp:s,error:r},duration:s-n,customEvents:m.length>0?m:void 0}),t.debug&&console.error("[mcp-logger] Request failed:",r),r}})):(t.debug&&console.log("[mcp-logger] Skipping instrumentation for method: "+a),r(e,s))},t.debug&&console.log("[mcp-logger] Server instrumentation complete")}(e,t),t.debug&&console.log("[mcp-logger] ✓ Initialization complete")},{addLog(e){const t=c.active().getValue(h);if(!t)return void console.warn("[mcp-logger] addLog called outside of handler context");const r={level:e.level||"info",message:e.message,metadata:e.metadata,timestamp:e.timestamp||Date.now()};t.push(r);const s=n.getSpan(c.active());s&&s.addEvent("custom."+r.level,{message:r.message,metadata:JSON.stringify(r.metadata||{}),timestamp:r.timestamp})},async shutdown(){await r()}});export{E as trace};

package/dist/sdk/index.js

@@ -1 +1 @@
-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};
+function e(){return g}function t(){return f}async function r(){if(u)try{await u.shutdown(),u=null,g=null,d=!1,f=null}catch(e){console.error("[MCP Logger] Error shutting down telemetry:",e)}}function s(e,t=1e4){try{const r=JSON.stringify(e);return r.length>t?r.slice(0,t)+"... (truncated)":r}catch(e){return null}}function o(r){const o=e();if(!o)return void console.error("[MCP Logger] Tracer not initialized, cannot create span");const n="mcp."+r.method;o.startActiveSpan(n,e=>{try{const o={"mcp.method":r.method,"mcp.source":r.source,"mcp.transport":r.transport,"mcp.log_type":"request-response","mcp.request.id":r.request.id+"","mcp.request.timestamp":r.request.timestamp,"mcp.request.params":s(r.request.params)||"{}","mcp.request.params.size":JSON.stringify(r.request.params||{}).length,"mcp.response.timestamp":r.response.timestamp,"mcp.duration_ms":r.duration};if("tools/call"===r.method&&r.request.params){const e=r.request.params.name,t=r.request.params.arguments;if(e&&(o["mcp.tool.name"]=e),t){const e=s(t);e&&(o["mcp.tool.arguments"]=e,o["mcp.tool.arguments.size"]=JSON.stringify(t).length)}}if(void 0!==r.response.result){const e=s(r.response.result);e&&(o["mcp.response.result"]=e,o["mcp.response.result.size"]=JSON.stringify(r.response.result).length)}if(r.request.headers){const e=s(r.request.headers);e&&(o["mcp.headers"]=e,o["mcp.headers.size"]=JSON.stringify(r.request.headers).length)}if("cli"===r.source){const e=t();e&&(o["mcp.cli.server"]=JSON.stringify({command:e.command,args:e.args,env:e.env}))}if(r.customEvents&&r.customEvents.length>0&&(o["mcp.events"]=JSON.stringify(r.customEvents),o["mcp.events.count"]=r.customEvents.length,r.customEvents.forEach(t=>{e.addEvent("custom."+(t.level||"info"),{message:t.message,metadata:JSON.stringify(t.metadata||{}),timestamp:t.timestamp||Date.now()})})),r.response.error){o["mcp.error"]=!0;const t=r.response.error instanceof Error?r.response.error.message:r.response.error+"";o["mcp.error.message"]=t,r.response.error instanceof Error&&e.recordException(r.response.error),e.setStatus({code:a.ERROR,message:t})}else e.setStatus({code:a.OK});!function(e,t){for(const[r,s]of Object.entries(t))null!=s&&e.setAttribute(r,s)}(e,o)}catch(t){console.error("[MCP Logger] Error creating paired span:",t),e.setStatus({code:a.ERROR,message:t+""})}finally{e.end()}})}import{trace as n,SpanStatusCode as a,context as c}from"@opentelemetry/api";import{NodeSDK as i}from"@opentelemetry/sdk-node";import{OTLPTraceExporter as m}from"@opentelemetry/exporter-trace-otlp-http";import{Resource as l}from"@opentelemetry/resources";const p={ENDPOINT:"https://aware.mcypher.com/v1/traces",SDK_VERSION:"1.0.0",SERVICE_NAME_PREFIX:"mcp-server",TRACKED_METHODS:["tools/call","tools/list"]};let u=null,g=null,d=!1,f=null;const h=Symbol("mcp-logger.customEvents"),E=Object.assign(function(e,t){if(!t.apiKey)throw Error("[mcp-logger] apiKey is required");if(!e)throw Error("[mcp-logger] server instance is required");!function(e){if(d)return e.debug&&console.error("[MCP Logger] Telemetry already initialized, returning existing tracer"),g;const t=e.serviceName||`${p.SERVICE_NAME_PREFIX}-${Math.random().toString(36).slice(2,8)}`;e.debug&&(console.error("[MCP Logger] Initializing telemetry..."),console.error("[MCP Logger] Endpoint: "+(e.endpoint||p.ENDPOINT)),console.error("[MCP Logger] Service: "+t)),u=new i({resource:new l({"service.name":t,"service.version":p.SDK_VERSION}),traceExporter:new m({url:e.endpoint||p.ENDPOINT,headers:{"x-api-key":e.apiKey}})}),u.start(),g=n.getTracer("mcp-logger",p.SDK_VERSION),d=!0,e.debug&&console.error("[MCP Logger] Telemetry initialized successfully");const s=async()=>{e.debug&&console.error("[MCP Logger] Shutting down telemetry..."),await r()};process.once("SIGTERM",s),process.once("SIGINT",s)}(t),function(e,t){const r=e.setRequestHandler.bind(e);e.setRequestHandler=function(e,s){const n=e.shape?.method,a=n?._def?.value||"unknown";return function(e){return p.TRACKED_METHODS.includes(e)}(a)?(t.debug&&console.log("[mcp-logger] Instrumenting handler: "+a),r(e,async(e,r)=>{const n=Date.now(),i=`${a}-${n}-${Math.random().toString(36).slice(2,8)}`,m=[],l=c.active().setValue(h,m);try{const p=await c.with(l,async()=>await s(e,r)),u=Date.now();return o({method:a,source:"sdk",transport:"stdio",request:{id:i,timestamp:n,params:e.params},response:{timestamp:u,result:p},duration:u-n,customEvents:m.length>0?m:void 0}),t.debug&&console.log(`[mcp-logger] Request completed (${u-n}ms):`,{method:a,customEvents:m.length}),p}catch(r){const s=Date.now();throw o({method:a,source:"sdk",transport:"stdio",request:{id:i,timestamp:n,params:e.params},response:{timestamp:s,error:r},duration:s-n,customEvents:m.length>0?m:void 0}),t.debug&&console.error("[mcp-logger] Request failed:",r),r}})):(t.debug&&console.log("[mcp-logger] Skipping instrumentation for method: "+a),r(e,s))},t.debug&&console.log("[mcp-logger] Server instrumentation complete")}(e,t),t.debug&&console.log("[mcp-logger] ✓ Initialization complete")},{addLog(e){const t=c.active().getValue(h);if(!t)return void console.warn("[mcp-logger] addLog called outside of handler context");const r={level:e.level||"info",message:e.message,metadata:e.metadata,timestamp:e.timestamp||Date.now()};t.push(r);const s=n.getSpan(c.active());s&&s.addEvent("custom."+r.level,{message:r.message,metadata:JSON.stringify(r.metadata||{}),timestamp:r.timestamp})},async shutdown(){await r()}});export{E as trace};

package/dist/sdk/instrumentation.js

@@ -1 +1 @@
-import"@opentelemetry/sdk-node";import"@opentelemetry/exporter-trace-otlp-http";import"@opentelemetry/resources";import"@opentelemetry/api";function e(e,t=!1){throw new Error("[MCP Logger SDK] Tracer not initialized. Call initMCPLogger first.")}export{e as instrumentMCPServer};
+function e(e){console.error("[MCP Logger] Tracer not initialized, cannot create span")}function t(t,o){const l=t.setRequestHandler.bind(t);t.setRequestHandler=function(t,s){const a=t.shape?.method,i=a?._def?.value||"unknown";return function(e){return r.TRACKED_METHODS.includes(e)}(i)?(o.debug&&console.log("[mcp-logger] Instrumenting handler: "+i),l(t,async(t,r)=>{const l=Date.now(),a=(Math.random().toString(36).slice(2,8),[]),m=n.active().setValue(c,a);try{const c=await n.with(m,async()=>await s(t,r)),u=Date.now();return e(t.params),o.debug&&console.log(`[mcp-logger] Request completed (${u-l}ms):`,{method:i,customEvents:a.length}),c}catch(n){throw e(t.params),o.debug&&console.error("[mcp-logger] Request failed:",n),n}})):(o.debug&&console.log("[mcp-logger] Skipping instrumentation for method: "+i),l(t,s))},o.debug&&console.log("[mcp-logger] Server instrumentation complete")}function o(){return n.active().getValue(c)}import{context as n}from"@opentelemetry/api";import"@opentelemetry/sdk-node";import"@opentelemetry/exporter-trace-otlp-http";import"@opentelemetry/resources";const r={TRACKED_METHODS:["tools/call","tools/list"]},c=Symbol("mcp-logger.customEvents");export{o as getCustomEventsFromContext,t as instrumentMCPServer};

package/dist/sdk/types.d.ts

@@ -5,6 +5,7 @@ import { Request, Result } from '@modelcontextprotocol/sdk/types.js';
 /**
  * 공통 타입 정의
  */
+
 /**
  * 텔레메트리 초기화 옵션
  */
@@ -28,16 +29,41 @@ interface TelemetryOptions {
      */
     debug?: boolean;
 }
+/**
+ * 커스텀 로그 엔트리
+ */
+interface CustomLogEntry$1 {
+    /**
+     * 로그 레벨
+     */
+    level?: 'info' | 'warn' | 'error';
+    /**
+     * 로그 메시지
+     */
+    message: string;
+    /**
+     * 추가 메타데이터 (자유 형식)
+     */
+    metadata?: Record<string, any>;
+    /**
+     * 타임스탬프 (자동 생성 가능)
+     */
+    timestamp?: number;
+}
 
 /**
  * SDK 타입 정의
  */
 
 /**
- * SDK 초기화 옵션 (TelemetryOptions 확장)
+ * Trace 옵션
  */
-interface SDKInitOptions extends TelemetryOptions {
+interface TraceOptions extends TelemetryOptions {
 }
+/**
+ * Custom Log Entry (re-export from core)
+ */
+type CustomLogEntry = CustomLogEntry$1;
 /**
  * MCP JSON-RPC Request 타입
  */
@@ -63,4 +89,4 @@ interface RequestHandlerExtra {
  */
 type MCPServer = Server;
 
-export type { MCPRequest, MCPRequestSchema, MCPResult, MCPServer, RequestHandlerExtra, SDKInitOptions };
+export type { CustomLogEntry, MCPRequest, MCPRequestSchema, MCPResult, MCPServer, RequestHandlerExtra, TraceOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awarecorp/mcp-logger",
-  "version": "0.0.2-dev.3",
+  "version": "0.0.2",
   "description": "Unified MCP observability solution - SDK for code integration and CLI for zero-config wrapping",
   "type": "module",
   "main": "dist/index.js",
@@ -19,6 +19,9 @@
     "prepublishOnly": "npm run build",
     "clean": "rm -rf dist",
     "dev": "tsc --watch",
+    "test": "mocha",
+    "test:watch": "mocha --watch",
+    "test:coverage": "c8 mocha",
     "test:cli": "npm run build:readable && node bin/mcp-logger.js --help",
     "publish:stable": "npm run build && npm publish --access public",
     "publish:dev": "npm run build && npm publish --access public --tag dev",
@@ -40,6 +43,14 @@
   ],
   "author": "Aware",
   "license": "MIT",
+  "homepage": "https://github.com/awarecorp/mcp-logger#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/awarecorp/mcp-logger.git"
+  },
+  "bugs": {
+    "url": "https://github.com/awarecorp/mcp-logger/issues"
+  },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^0.5.0"
   },
@@ -60,10 +71,15 @@
     "@modelcontextprotocol/sdk": "^0.5.0",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.4",
+    "@types/chai": "^5.2.3",
+    "@types/mocha": "^10.0.10",
     "@types/node": "^20.0.0",
+    "chai": "^6.2.0",
+    "mocha": "^11.7.4",
     "rollup": "^4.52.5",
     "rollup-plugin-dts": "^6.2.3",
     "tslib": "^2.8.1",
+    "tsx": "^4.20.6",
     "typescript": "^5.3.0"
   },
   "engines": {

package/dist/cli/cli.js

@@ -1,2 +0,0 @@
-#!/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",p="1.0.0";let g=null,d=null,m=!1;function l(){return d}async function u(){if(g)try{await g.shutdown(),g=null,d=null,m=!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("-e, --endpoint <url>","Custom OTLP endpoint").argument("<command...>","MCP server command to wrap").action(async(r,n)=>{try{const c=!0;!function(e){if(m)return console.error("[MCP Logger] Telemetry already initialized, returning existing tracer"),d;const r=e.serviceName||`mcp-server-${Math.random().toString(36).slice(2,8)}`;console.error("[MCP Logger] Initializing telemetry..."),console.error(`[MCP Logger] Endpoint: ${e.endpoint||a}`),console.error(`[MCP Logger] Service: ${r}`),g=new t({resource:new s({"service.name":r,"service.version":p}),traceExporter:new o({url:e.endpoint||a,headers:{"x-api-key":e.apiKey}})}),g.start(),d=i.getTracer("mcp-logger",p),m=!0,console.error("[MCP Logger] Telemetry initialized successfully");const n=async()=>{console.error("[MCP Logger] Shutting down telemetry..."),await u()};process.once("SIGTERM",n),process.once("SIGINT",n)}({...n,debug:c}),console.error("[MCP Logger CLI] Starting MCP server:",r.join(" "));const[l,...h]=r,C=e(l,h,{stdio:["pipe","pipe","inherit"],env:{...process.env,MCP_LOGGER_ENABLED:"true"}}),y=new f("request",c);process.stdin.pipe(y).pipe(C.stdin);const L=new f("response",c);C.stdout.pipe(L).pipe(process.stdout),C.on("error",async e=>{console.error("[MCP Logger CLI] Failed to start MCP server:",e),await u(),process.exit(1)}),C.on("exit",async(e,r)=>{console.error(`[MCP Logger CLI] MCP server exited with code ${e}, signal ${r}`),await u(),process.exit(e||0)});let M=!1;const P=async e=>{M||(M=!0,console.error(`[MCP Logger CLI] Received ${e}, shutting down...`),C.kill(e),await Promise.race([new Promise(e=>C.once("exit",e)),new Promise(e=>setTimeout(e,5e3))]),await u(),process.exit(0))};process.on("SIGTERM",()=>P("SIGTERM")),process.on("SIGINT",()=>P("SIGINT"))}catch(e){console.error("[MCP Logger CLI] Fatal error:",e),await u(),process.exit(1)}}),r.parse();

package/dist/shared/config.js

@@ -1 +0,0 @@
-const e={ENDPOINT:"https://aware.mcypher.com/v1/traces",SDK_VERSION:"1.0.0",SERVICE_NAME_PREFIX:"mcp-server"};export{e as CONFIG};

package/dist/shared/span-utils.js

@@ -1 +0,0 @@
-import{SpanStatusCode as t,context as r,trace as e}from"@opentelemetry/api";function n(t,r){for(const[e,n]of Object.entries(r))null!=n&&t.setAttribute(e,n)}function o(t,r,e,n){try{e?t.addEvent(r,e):t.addEvent(r)}catch(t){n&&console.error("[MCP Logger] Failed to add span event:",t)}}function c(r,e,n){const o=e instanceof Error?e.message:"Unknown error",c=e instanceof Error?e.constructor.name:"Error";e instanceof Error&&r.recordException(e),r.setStatus({code:t.ERROR,message:o}),r.setAttribute("error",!0),r.setAttribute("error.type",c),r.setAttribute("error.message",o),n&&console.error("[MCP Logger] Error recorded in span:",e)}function s(r){r.setStatus({code:t.OK})}function a(t,r=1e4){try{const e=JSON.stringify(t);return e.length>r?e.slice(0,r)+"... (truncated)":e}catch(t){return null}}function i(){const t={},n=r.active(),o=e.getSpan(n);if(o){const r=o.spanContext();r&&(t.traceparent=`00-${r.traceId}-${r.spanId}-01`)}return t}export{o as addSpanEvent,i as getTraceHeaders,s as markSpanSuccess,c as recordSpanError,a as safeStringify,n as setSpanAttributes};

package/dist/shared/telemetry.js

@@ -1 +0,0 @@
-import{NodeSDK as e}from"@opentelemetry/sdk-node";import{OTLPTraceExporter as r}from"@opentelemetry/exporter-trace-otlp-http";import{Resource as o}from"@opentelemetry/resources";import{trace as t}from"@opentelemetry/api";const n="https://aware.mcypher.com/v1/traces",i="1.0.0";let c=null,s=null,l=!1;function a(a){if(l)return a.debug&&console.error("[MCP Logger] Telemetry already initialized, returning existing tracer"),s;const g=a.serviceName||`mcp-server-${Math.random().toString(36).slice(2,8)}`;a.debug&&(console.error("[MCP Logger] Initializing telemetry..."),console.error(`[MCP Logger] Endpoint: ${a.endpoint||n}`),console.error(`[MCP Logger] Service: ${g}`)),c=new e({resource:new o({"service.name":g,"service.version":i}),traceExporter:new r({url:a.endpoint||n,headers:{"x-api-key":a.apiKey}})}),c.start(),s=t.getTracer("mcp-logger",i),l=!0,a.debug&&console.error("[MCP Logger] Telemetry initialized successfully");const p=async()=>{a.debug&&console.error("[MCP Logger] Shutting down telemetry..."),await u()};return process.once("SIGTERM",p),process.once("SIGINT",p),s}function g(){return s}function p(){return l}async function u(){if(c)try{await c.shutdown(),c=null,s=null,l=!1}catch(e){console.error("[MCP Logger] Error shutting down telemetry:",e)}}export{g as getTracer,a as initializeTelemetry,p as isInitializedTelemetry,u as shutdownTelemetry};

package/dist/shared/types.d.ts

@@ -1,53 +0,0 @@
-/**
- * 공통 타입 정의
- */
-/**
- * 텔레메트리 초기화 옵션
- */
-interface TelemetryOptions {
-    /**
-     * API Key for authentication (필수)
-     */
-    apiKey: string;
-    /**
-     * 서비스 이름 (옵션)
-     * 지정하지 않으면 자동으로 'mcp-server-{random}' 형식으로 생성
-     */
-    serviceName?: string;
-    /**
-     * 커스텀 OTLP 엔드포인트 (옵션)
-     * 기본값: CONFIG.ENDPOINT
-     */
-    endpoint?: string;
-    /**
-     * 디버그 로그 활성화 (옵션)
-     */
-    debug?: boolean;
-}
-/**
- * Span 속성 인터페이스
- */
-interface SpanAttributes {
-    [key: string]: string | number | boolean | undefined;
-}
-/**
- * MCP 메시지 방향
- */
-type MessageDirection = 'request' | 'response';
-/**
- * JSON-RPC 메시지 타입
- */
-interface JSONRPCMessage {
-    jsonrpc: '2.0';
-    id?: string | number;
-    method?: string;
-    params?: any;
-    result?: any;
-    error?: {
-        code: number;
-        message: string;
-        data?: any;
-    };
-}
-
-export type { JSONRPCMessage, MessageDirection, SpanAttributes, TelemetryOptions };