@awarecorp/mcp-logger 0.0.2-dev.2 → 0.0.2-dev.5

package/README.md

@@ -1,49 +1,51 @@
 # @awarecorp/mcp-logger
 
-**통합 MCP Observability 솔루션** - 하나의 패키지로 SDK와 CLI를 모두 제공합니다.
+**Unified MCP Observability Solution** - One package for both SDK and CLI.
+
+[한국어 문서](./docs/README.ko.md)
 
 ---
 
-## 🎯 두 가지 사용 방법
+## 🎯 Two Ways to Use
 
-### 1️⃣ **SDK**: 코드에 직접 통합
-당신이 MCP 서버를 개발하고 있다면, SDK를 사용하세요.
+### 1️⃣ **SDK**: Direct Code Integration
+If you're developing an MCP server, use the SDK.
 
-### 2️⃣ **CLI**: 코드 수정 없이 래핑
-이미 만들어진 MCP 서버(npm 패키지)를 사용한다면, CLI를 사용하세요.
+### 2️⃣ **CLI**: Zero-Code Wrapper
+If you're using an existing MCP server (npm package), use the CLI.
 
 ---
 
-## 📦 설치
+## 📦 Installation
 
-```bash
+\`\`\`bash
 npm install @awarecorp/mcp-logger
-```
+\`\`\`
 
 ---
 
-## 1️⃣ SDK 사용법
+## 1️⃣ SDK Usage
 
 ### TypeScript
 
-```typescript
+\`\`\`typescript
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { initMCPLogger } from '@awarecorp/mcp-logger';
+import { trace } from '@awarecorp/mcp-logger';
 
 const server = new Server(
   { name: 'my-server', version: '1.0.0' },
   { capabilities: { tools: {} } }
 );
 
-// 🔥 자동 계측 활성화 (이것만 추가하면 됩니다!)
-initMCPLogger(server, {
+// 🔥 Enable auto-instrumentation (just add this!)
+trace(server, {
   apiKey: process.env.AWARE_API_KEY!,
   serviceName: 'my-awesome-mcp-server',
-  debug: true, // 디버그 로그 활성화 (선택사항)
+  debug: true, // Enable debug logs (optional)
 });
 
-// 평소처럼 핸들러 등록
+// Register handlers as usual
 server.setRequestHandler('tools/list', async () => ({
   tools: [
     { name: 'read_file', description: 'Read a file' },
@@ -53,29 +55,37 @@ server.setRequestHandler('tools/list', async () => ({
 
 server.setRequestHandler('tools/call', async (request) => {
   const { name, arguments: args } = request.params;
-  // 이 핸들러는 자동으로 로깅됩니다!
-  return { result: `Called ${name}` };
+  
+  // ✨ Add custom logs (optional)
+  trace.addLog({ level: 'info', message: \`Processing \${name}\` });
+  
+  // Business logic
+  const result = await processToolCall(name, args);
+  
+  trace.addLog({ level: 'info', message: 'Processing completed' });
+  
+  return { result };
 });
 
-// stdio transport 시작
+// Start stdio transport
 const transport = new StdioServerTransport();
 await server.connect(transport);
-```
+\`\`\`
 
 ### JavaScript (CommonJS)
 
-```javascript
+\`\`\`javascript
 const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
 const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
-const { initMCPLogger } = require('@awarecorp/mcp-logger');
+const { trace } = require('@awarecorp/mcp-logger');
 
 const server = new Server(
   { name: 'my-server', version: '1.0.0' },
   { capabilities: { tools: {} } }
 );
 
-// 🔥 자동 계측 활성화
-initMCPLogger(server, {
+// 🔥 Enable auto-instrumentation
+trace(server, {
   apiKey: process.env.AWARE_API_KEY,
   serviceName: 'my-mcp-server',
 });
@@ -84,60 +94,110 @@ server.setRequestHandler('tools/list', async () => ({
   tools: [{ name: 'test', description: 'Test tool' }],
 }));
 
+server.setRequestHandler('tools/call', async (request) => {
+  // Add custom logs
+  trace.addLog({ level: 'info', message: 'Tool called' });
+  
+  return { result: 'success' };
+});
+
 const transport = new StdioServerTransport();
 server.connect(transport);
-```
+\`\`\`
 
 ### SDK API
 
-#### `initMCPLogger(server, options)`
+#### \`trace(server, options)\`
 
-MCP 서버에 자동 계측을 추가합니다.
+Add auto-instrumentation to your MCP server.
 
 **Parameters:**
-- `server` (`MCPServer`): MCP Server 인스턴스
-- `options` (`SDKInitOptions`):
-  - `apiKey` (string, 필수): Aware API 키
-  - `serviceName` (string, 옵션): 서비스 이름 (기본값: 자동 생성)
-  - `debug` (boolean, 옵션): 디버그 로그 활성화 (기본값: false)
-  - `endpoint` (string, 옵션): 커스텀 OTLP 엔드포인트
+- \`server\` (\`MCPServer\`): MCP Server instance
+- \`options\` (\`TraceOptions\`):
+  - \`apiKey\` (string, required): Aware API key
+  - \`serviceName\` (string, optional): Service name (default: auto-generated)
+  - \`debug\` (boolean, optional): Enable debug logs (default: false)
+  - \`endpoint\` (string, optional): Custom OTLP endpoint
+
+**Returns:** \`void\`
+
+---
+
+#### \`trace.addLog(entry)\`
+
+Add custom logs to the currently executing tool handler.
+
+**Parameters:**
+- \`entry\` (\`CustomLogEntry\`):
+  - \`level\` ('info' | 'warn' | 'error', optional): Log level (default: 'info')
+  - \`message\` (string, required): Log message
+  - \`metadata\` (object, optional): Additional metadata
+
+**Returns:** \`void\`
+
+**Example:**
+\`\`\`typescript
+server.setRequestHandler('tools/call', async (request) => {
+  trace.addLog({ 
+    level: 'info', 
+    message: 'Processing started',
+    metadata: { userId: '123', action: 'read' }
+  });
+  
+  // Business logic...
+  
+  trace.addLog({ level: 'info', message: 'Processing completed' });
+  
+  return { result: 'success' };
+});
+\`\`\`
+
+---
+
+#### \`trace.shutdown()\`
+
+Shutdown telemetry and flush remaining data.
 
-**Returns:** `void`
+**Returns:** \`Promise<void>\`
 
-**Throws:**
-- `Error`: apiKey가 제공되지 않은 경우
-- `Error`: server 인스턴스가 제공되지 않은 경우
+**Example:**
+\`\`\`typescript
+process.on('SIGTERM', async () => {
+  await trace.shutdown();
+  process.exit(0);
+});
+\`\`\`
 
 ---
 
-## 2️⃣ CLI 사용법
+## 2️⃣ CLI Usage
 
-### 기본 사용법
+### Quick Start
 
-```bash
-npx @awarecorp/mcp-logger \
-  --api-key YOUR_API_KEY \
-  -- \
+\`\`\`bash
+npx @awarecorp/mcp-logger \\
+  --api-key YOUR_API_KEY \\
+  -- \\
   npx @modelcontextprotocol/server-filesystem /path/to/dir
-```
+\`\`\`
 
-`--` 뒤에 원래 사용하던 MCP 서버 명령어를 그대로 입력하면 됩니다.
+Just add your MCP server command after \`--\`.
 
-### 전역 설치 (선택사항)
+### Global Installation (Optional)
 
-```bash
+\`\`\`bash
 npm install -g @awarecorp/mcp-logger
-```
+\`\`\`
 
-사용:
-```bash
+Usage:
+\`\`\`bash
 mcp-logger --api-key YOUR_KEY -- npx server-filesystem /path
-```
+\`\`\`
 
-### Claude Desktop 설정
+### Claude Desktop Configuration
 
-#### Before (관측성 없음)
-```json
+#### Before (No Observability)
+\`\`\`json
 {
   "mcpServers": {
     "filesystem": {
@@ -146,10 +206,10 @@ mcp-logger --api-key YOUR_KEY -- npx server-filesystem /path
     }
   }
 }
-```
+\`\`\`
 
-#### After (관측성 추가) ✨
-```json
+#### After (With Observability) ✨
+\`\`\`json
 {
   "mcpServers": {
     "filesystem": {
@@ -166,141 +226,196 @@ mcp-logger --api-key YOUR_KEY -- npx server-filesystem /path
     }
   }
 }
-```
+\`\`\`
 
-**이게 전부입니다!** 코드 수정 없이 모든 요청/응답이 Aware 플랫폼에 기록됩니다.
+**That's it!** All requests/responses are now logged to the Aware platform without code changes.
 
-### CLI 옵션
+### CLI Options
 
-#### 필수 옵션
-- `--api-key <key>` 또는 `-k <key>`: Aware API 키 (필수)
+#### Required Options
+- \`--api-key <key>\` or \`-k <key>\`: Aware API key (required)
 
-#### 선택 옵션
-- `--service-name <name>` 또는 `-s <name>`: 서비스 식별 이름 (기본값: 자동 생성)
-- `--debug` 또는 `-d`: 디버그 로그 활성화
-- `--endpoint <url>` 또는 `-e <url>`: 커스텀 OTLP 엔드포인트
+#### Optional Options
+- \`--service-name <name>\` or \`-s <name>\`: Service identifier name (default: auto-generated)
+- \`--debug\` or \`-d\`: Enable debug logs
+- \`--endpoint <url>\` or \`-e <url>\`: Custom OTLP endpoint
 
-### CLI 사용 예시
+### CLI Usage Examples
 
-#### 파일시스템 서버
-```bash
-npx @awarecorp/mcp-logger \
-  --api-key abc123 \
-  --service-name my-filesystem \
-  -- \
+#### Filesystem Server
+\`\`\`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 \
-  -- \
+\`\`\`
+
+#### GitHub Server
+\`\`\`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 \
-  -- \
+\`\`\`
+
+#### Brave Search Server (Debug Mode)
+\`\`\`bash
+npx @awarecorp/mcp-logger \\
+  --api-key abc123 \\
+  --service-name brave-search \\
+  --debug \\
+  -- \\
   npx -y @modelcontextprotocol/server-brave-search
-```
+\`\`\`
 
 ---
 
-## 🏗️ 아키텍처
+## 🏗️ Architecture
 
-이 패키지는 세 가지 레이어로 구성되어 있습니다:
+This package consists of three layers:
 
-```
+\`\`\`
 @awarecorp/mcp-logger
-├── SDK (공개 API)
-│   ├── initMCPLogger()    - MCP 서버 계측
-│   └── shutdown()          - 텔레메트리 종료
+├── SDK (Public API)
+│   ├── trace()            - Instrument MCP server
+│   ├── trace.addLog()     - Add custom logs
+│   └── trace.shutdown()   - Shutdown telemetry
 │
-├── CLI (바이너리만 접근 가능)
-│   └── mcp-logger          - CLI 래퍼
+├── CLI (Binary-only access)
+│   ├── main.ts            - CLI entry point
+│   ├── interceptor.ts     - Stream interception
+│   └── pairing.ts         - Request-Response matching
 │
-└── Shared (내부 구현)
-    ├── telemetry           - OpenTelemetry 초기화
-    ├── span-utils          - Span 유틸리티
-    └── config              - 공통 설정
-```
+└── Core (Internal implementation)
+    ├── telemetry          - OpenTelemetry initialization
+    ├── span-builder       - Unified Span creation
+    ├── span-utils         - Span utilities
+    ├── config             - Tracked method configuration
+    └── types              - Common type definitions
+\`\`\`
+
+### Key Features
+
+#### ✅ Request-Response Pairing
+- Matches requests and responses by ID into a **single span**
+- Automatic cleanup of incomplete requests with 30s timeout
+
+#### ✅ Selective Tracking
+- Only tracks \`tools/call\` and \`tools/list\` (removes unnecessary overhead)
+- Configurable to extend tracking targets
+
+#### ✅ Custom Events
+- Add custom events inside handlers with \`trace.addLog()\`
+- Automatically linked to the currently executing span via context
 
-### 중요한 설계 원칙
+#### ✅ Elasticsearch Optimization
+- Extracts tool name and arguments as top-level fields
+- Fast searching with \`mcp.tool.name\`, \`mcp.tool.arguments\`, etc.
 
-1. **SDK만 공개 API로 노출**: `import`로는 SDK만 접근 가능
-2. **CLI는 바이너리로만 접근**: `npx` 또는 `mcp-logger` 명령어로만 사용
-3. **공통 코드 재사용**: OpenTelemetry 로직은 shared 레이어에서 통합 관리
-4. **타입 안전성**: CLI는 타입 정의가 노출되지 않음
+### Design Principles
+
+1. **SDK-only public API**: Only SDK accessible via \`import\`
+2. **CLI binary-only access**: Use via \`npx\` or \`mcp-logger\` command only
+3. **Shared code reuse**: OpenTelemetry logic unified in core layer
+4. **Type safety**: CLI type definitions not exposed
+5. **dd-trace style API**: Intuitive usage with \`trace()\` namespace
 
 ---
 
-## 🔧 개발
+## 🔧 Development
 
-### 빌드
+### Build
 
-```bash
+\`\`\`bash
 npm run build
-```
+\`\`\`
+
+### Tests
+
+\`\`\`bash
+npm test                 # Run all tests
+npm run test:watch       # Watch mode
+\`\`\`
 
-### 로컬 테스트
+### Local Testing
 
-#### SDK 테스트
-```typescript
+#### SDK Testing
+\`\`\`typescript
 // test.ts
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { initMCPLogger } from './src/index.js';
+import { trace } from './src/index.js';
 
 const server = new Server({ name: 'test', version: '1.0.0' }, { capabilities: {} });
-initMCPLogger(server, { apiKey: 'test', debug: true });
-```
+trace(server, { apiKey: 'test', debug: true });
 
-#### CLI 테스트
-```bash
+server.setRequestHandler('tools/call', async (request) => {
+  trace.addLog({ level: 'info', message: 'Test handler called' });
+  return { result: 'success' };
+});
+\`\`\`
+
+#### CLI Testing
+\`\`\`bash
 npm run build
 node bin/mcp-logger.js --help
-```
+\`\`\`
 
 ---
 
-## 📝 라이선스
+## 📝 License
 
 MIT
 
 ---
 
-## 🤝 기여
+## 🤝 Contributing
 
-이슈와 PR은 언제나 환영합니다!
+Issues and PRs are always welcome!
 
-자세한 개발 가이드는 [DEVELOPMENT.md](./DEVELOPMENT.md)를 참조하세요.
+See [DEVELOPMENT.md](./DEVELOPMENT.md) for detailed development guidelines.
 
 ---
 
-## 📦 배포 (Maintainers Only)
+## 📦 Publishing (Maintainers Only)
 
-### Stable 버전 배포
-```bash
-npm run version:patch    # 또는 minor, major
-npm run publish:stable
-```
+**Recommended:** Automated deployment with GitHub Actions
 
-### Dev 버전 배포
-```bash
+### Automated Deployment (GitHub Actions) ⭐
+\`\`\`bash
+# Dev version (develop branch)
+git checkout develop
 npm run version:dev
-npm run publish:dev
-```
+git push origin develop --tags
+
+# Production version (main branch)
+git checkout main
+npm run version:patch  # or minor, major
+git push origin main --tags
+\`\`\`
 
-자세한 내용은 [DEVELOPMENT.md](./DEVELOPMENT.md#배포)를 참조하세요.
+GitHub Actions will automatically build and publish to npm.
+
+### Manual Deployment (Not Recommended)
+\`\`\`bash
+# Dev version
+npm run build
+npm publish --access public --tag dev
+
+# Production version
+npm run build
+npm publish --access public
+\`\`\`
 
 ---
 
-## 📞 지원
+## 🌐 Links
+
+- **Aware Platform**: https://aware.mcypher.com
+- **MCP Specification**: https://modelcontextprotocol.io
+- **GitHub Repository**: https://github.com/awarecorp/mcp-logger
+
+---
 
-- 문서: [https://aware.mcypher.com/docs](https://aware.mcypher.com/docs)
-- 이슈: [GitHub Issues](https://github.com/your-org/mcp-logger/issues)
+Made with ❤️ by [Aware](https://aware.mcypher.com)

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

package/dist/core/span-builder.js

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

package/dist/core/telemetry.js

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

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/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 };