@uvrn/mcp 1.0.0

package/README.md

@@ -0,0 +1,446 @@
+# @uvrn/mcp
+
+**MCP Server for UVRN Delta Engine - AI-Native Bundle Processing**
+
+[![npm version](https://img.shields.io/npm/v/@uvrn/mcp.svg)](https://www.npmjs.com/package/@uvrn/mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+The Delta Engine MCP server exposes UVRN's Delta Engine functionality to AI assistants through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). This enables AI assistants like Claude Desktop to process bundles, validate data structures, and verify receipts without any adapter code.
+
+### What is MCP?
+
+**Model Context Protocol (MCP)** is an open standard for connecting AI assistants to external tools and data sources. Think of it as a universal "plugin system" for AI assistants.
+
+### Why Use This Server?
+
+- **AI-Native Integration**: Use Delta Engine directly from Claude Desktop or any MCP-compatible client
+- **Zero Adapter Code**: No need to write custom integrations—just configure and go
+- **Type-Safe Operations**: Full TypeScript type safety with comprehensive validation
+- **Production Ready**: Battle-tested validation, error handling, and logging
+
+## Features
+
+### 🔧 Three MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| **`delta_run_engine`** | Execute Delta Engine on bundles to verify data consensus across sources |
+| **`delta_validate_bundle`** | Validate bundle structure without executing (fast pre-flight check) |
+| **`delta_verify_receipt`** | Verify receipt integrity by recomputing hashes |
+
+### 📦 Four MCP Resources
+
+| Resource URI | Description |
+|--------------|-------------|
+| `mcp://delta-engine/schema/bundle` | JSON schema for DeltaBundle structure |
+| `mcp://delta-engine/schema/receipt` | JSON schema for DeltaReceipt structure |
+| `mcp://delta-engine/receipts/{uvrn}` | Retrieve receipts by UVRN *(storage not yet implemented)* |
+| `mcp://delta-engine/bundles/{id}` | Retrieve bundles by ID *(storage not yet implemented)* |
+
+### 💡 Three MCP Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| **`verify_data`** | Template for data verification queries |
+| **`create_bundle`** | Guided bundle creation with placeholder data |
+| **`analyze_receipt`** | Receipt analysis and explanation template |
+
+## Installation
+
+### Global Installation (Recommended for CLI use)
+
+```bash
+npm install -g @uvrn/mcp
+```
+
+### Local Project Installation
+
+```bash
+npm install @uvrn/mcp
+```
+
+### Requirements
+
+- Node.js >= 18.0.0
+- npm >= 9.0.0
+
+## Quick Start
+
+### Claude Desktop Configuration
+
+Add to your `claude_desktop_config.json`:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "delta-engine": {
+      "command": "npx",
+      "args": ["-y", "@uvrn/mcp"]
+    }
+  }
+}
+```
+
+**With environment variables:**
+
+```json
+{
+  "mcpServers": {
+    "delta-engine": {
+      "command": "npx",
+      "args": ["-y", "@uvrn/mcp"],
+      "env": {
+        "LOG_LEVEL": "info",
+        "MAX_BUNDLE_SIZE": "10485760"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop, and the Delta Engine tools will be available!
+
+### Running Standalone
+
+```bash
+# Global installation
+uvrn-mcp
+
+# Using npx
+npx @uvrn/mcp
+
+# Local installation
+node node_modules/@uvrn/mcp/dist/index.js
+```
+
+## Tools Reference
+
+### `delta_run_engine`
+
+Execute the Delta Engine on a bundle to verify data consensus.
+
+**Input:**
+```json
+{
+  "bundle": {
+    "bundleId": "test-bundle-001",
+    "claim": "Product X has 10,000 sales",
+    "dataSpecs": [
+      {
+        "id": "source-1",
+        "label": "Internal CRM",
+        "sourceKind": "report",
+        "originDocIds": ["crm-2024-01"],
+        "metrics": [
+          { "key": "sales_count", "value": 10000 }
+        ]
+      },
+      {
+        "id": "source-2",
+        "label": "Analytics Platform",
+        "sourceKind": "metric",
+        "originDocIds": ["analytics-dashboard"],
+        "metrics": [
+          { "key": "sales_count", "value": 9950 }
+        ]
+      }
+    ],
+    "thresholdPct": 0.05
+  }
+}
+```
+
+**Output:**
+```json
+{
+  "receipt": {
+    "bundleId": "test-bundle-001",
+    "deltaFinal": 50,
+    "outcome": "consensus",
+    "rounds": [...],
+    "hash": "sha256:abc123...",
+    "ts": "2026-01-15T12:00:00Z"
+  },
+  "success": true
+}
+```
+
+**Error Scenarios:**
+- `VALIDATION_ERROR`: Bundle structure invalid or thresholdPct out of range
+- `EXECUTION_ERROR`: Engine execution failed (check bundle data)
+
+---
+
+### `delta_validate_bundle`
+
+Validate bundle structure without executing the engine.
+
+**Input:**
+```json
+{
+  "bundle": {
+    "bundleId": "test-bundle-001",
+    "claim": "...",
+    "dataSpecs": [...],
+    "thresholdPct": 0.05
+  }
+}
+```
+
+**Output (Success):**
+```json
+{
+  "valid": true,
+  "details": "Bundle \"test-bundle-001\" is valid with 2 data specs"
+}
+```
+
+**Output (Failure):**
+```json
+{
+  "valid": false,
+  "error": "thresholdPct must be > 0 and <= 1",
+  "details": "thresholdPct must be > 0 and <= 1"
+}
+```
+
+---
+
+### `delta_verify_receipt`
+
+Verify receipt integrity by recomputing its hash.
+
+**Input:**
+```json
+{
+  "receipt": {
+    "bundleId": "test-bundle-001",
+    "deltaFinal": 50,
+    "sources": ["source-1", "source-2"],
+    "rounds": [...],
+    "outcome": "consensus",
+    "hash": "sha256:abc123...",
+    "ts": "2026-01-15T12:00:00Z"
+  }
+}
+```
+
+**Output (Valid):**
+```json
+{
+  "verified": true,
+  "recomputedHash": "sha256:abc123...",
+  "details": "Receipt for bundle \"test-bundle-001\" is valid. Hash verified: sha256:abc123..."
+}
+```
+
+**Output (Invalid):**
+```json
+{
+  "verified": false,
+  "error": "Hash mismatch",
+  "details": "Expected sha256:abc123..., got sha256:def456..."
+}
+```
+
+## Resources Reference
+
+### Schema Resources
+
+**Get Bundle Schema:**
+```
+URI: mcp://delta-engine/schema/bundle
+Returns: JSON Schema for DeltaBundle
+```
+
+**Get Receipt Schema:**
+```
+URI: mcp://delta-engine/schema/receipt
+Returns: JSON Schema for DeltaReceipt
+```
+
+### Data Resources (Not Yet Implemented)
+
+> [!NOTE]
+> Receipt and bundle retrieval resources are declared but not functional in Phase A.3 (storage layer not implemented).
+
+**Get Receipt by UVRN:**
+```
+URI: mcp://delta-engine/receipts/{uvrn}
+Status: Planned for future phase
+```
+
+**Get Bundle by ID:**
+```
+URI: mcp://delta-engine/bundles/{id}
+Status: Planned for future phase
+```
+
+## Prompts Reference
+
+### `verify_data`
+
+Template for data verification queries.
+
+**Usage in Claude:**
+```
+Use the verify_data prompt to help me verify this claim: "..."
+```
+
+### `create_bundle`
+
+Guided bundle creation with examples.
+
+**Usage in Claude:**
+```
+Use the create_bundle prompt to help me create a bundle for verifying revenue data
+```
+
+### `analyze_receipt`
+
+Receipt analysis and explanation.
+
+**Usage in Claude:**
+```
+Use the analyze_receipt prompt to explain this receipt: {...}
+```
+
+## Configuration
+
+See [ENVIRONMENT.md](./ENVIRONMENT.md) for detailed configuration options.
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `LOG_LEVEL` | `info` | Logging verbosity (`debug`, `info`, `warn`, `error`) |
+| `MAX_BUNDLE_SIZE` | `10485760` | Maximum bundle size in bytes (10 MB) |
+| `VERBOSE_ERRORS` | `false` | Include stack traces in error responses |
+| `STORAGE_PATH` | (none) | Optional storage path (not yet implemented) |
+
+**Example:**
+```bash
+LOG_LEVEL=debug MAX_BUNDLE_SIZE=20971520 npx @uvrn/mcp
+```
+
+## Troubleshooting
+
+### Server doesn't appear in Claude Desktop
+
+1. Check your `claude_desktop_config.json` syntax (must be valid JSON)
+2. Verify the file path is correct for your OS
+3. Restart Claude Desktop completely
+4. Check Claude Desktop logs for errors
+
+**macOS Logs:**
+```bash
+tail -f ~/Library/Logs/Claude/mcp*.log
+```
+
+### Tool execution fails
+
+**Check bundle validation first:**
+```json
+{
+  "tool": "delta_validate_bundle",
+  "arguments": {
+    "bundle": { ...your bundle... }
+  }
+}
+```
+
+**Common issues:**
+- `thresholdPct` must be > 0 and <= 1
+- Need at least 2 data specs
+- Each metric must have `key` and `value`
+
+### Performance issues
+
+**Reduce bundle size:**
+- Limit number of data specs
+- Reduce metrics per data spec
+- Set lower `MAX_BUNDLE_SIZE`
+
+**Enable debug logging:**
+```bash
+LOG_LEVEL=debug npx @uvrn/mcp
+```
+
+### Type errors in TypeScript projects
+
+Ensure you're importing types correctly:
+
+```typescript
+import type { DeltaBundle, DeltaReceipt } from '@uvrn/mcp';
+```
+
+## Development
+
+### Building from Source
+
+```bash
+git clone https://github.com/your-repo/lc_delta-core.git
+cd lc_delta-core/packages/uvrn-mcp
+npm install
+npm run build
+```
+
+### Running Tests
+
+```bash
+npm test
+```
+
+### Local Development with Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "delta-engine-dev": {
+      "command": "node",
+      "args": ["/absolute/path/to/packages/uvrn-mcp/dist/index.js"],
+      "env": {
+        "LOG_LEVEL": "debug",
+        "VERBOSE_ERRORS": "true"
+      }
+    }
+  }
+}
+```
+
+## Architecture
+
+For detailed architecture information, see [MCP_INTEGRATION.md](../docs/MCP_INTEGRATION.md).
+
+```mermaid
+graph LR
+    A[Claude Desktop] -->|MCP Protocol| B[Delta Engine MCP Server]
+    B -->|Executes| C[Delta Engine Core]
+    C -->|Returns| D[DeltaReceipt]
+    D -->|via MCP| A
+```
+
+## Related Documentation
+
+- [MCP Integration Guide](../../docs/MCP_INTEGRATION.md) - Detailed integration patterns
+- [ENVIRONMENT.md](./ENVIRONMENT.md) - Configuration reference
+- [CLAUDE_DESKTOP_SETUP.md](./CLAUDE_DESKTOP_SETUP.md) - Setup guide
+- [Phase A.3 Task List](../../admin/docs/build-plans/phase_a3_task_list.md) - Implementation details
+
+## License
+
+MIT
+
+## Related Projects
+
+- [Loosechain Delta Engine Core](../uvrn-core) - Core engine functionality
+- [MCP Protocol Specification](https://modelcontextprotocol.io/) - Official MCP docs
+
+---
+
+**Loosechain** - _Receipts are truth. Interfaces are untrusted. Verification comes first._

package/dist/__tests__/fixtures/bundles.d.ts

@@ -0,0 +1,4 @@
+import type { DeltaBundle } from '@uvrn/core';
+export declare function createTestBundle(overrides?: Partial<DeltaBundle>): DeltaBundle;
+export declare function createDivergentBundle(overrides?: Partial<DeltaBundle>): DeltaBundle;
+//# sourceMappingURL=bundles.d.ts.map

package/dist/__tests__/fixtures/bundles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundles.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/bundles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAsC9C,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAMlF;AAED,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GACnC,WAAW,CA4Bb"}

package/dist/__tests__/fixtures/bundles.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestBundle = createTestBundle;
+exports.createDivergentBundle = createDivergentBundle;
+const baseBundle = {
+    bundleId: 'test-bundle-001',
+    claim: 'Q1 revenue is approximately $1.2M',
+    thresholdPct: 0.05,
+    dataSpecs: [
+        {
+            id: 'source-a',
+            label: 'Source A',
+            sourceKind: 'report',
+            originDocIds: ['doc-a'],
+            metrics: [
+                {
+                    key: 'revenue',
+                    value: 1200000,
+                    unit: 'USD',
+                    ts: '2024-04-01T00:00:00Z',
+                },
+            ],
+        },
+        {
+            id: 'source-b',
+            label: 'Source B',
+            sourceKind: 'report',
+            originDocIds: ['doc-b'],
+            metrics: [
+                {
+                    key: 'revenue',
+                    value: 1195000,
+                    unit: 'USD',
+                    ts: '2024-04-01T00:00:00Z',
+                },
+            ],
+        },
+    ],
+};
+function createTestBundle(overrides = {}) {
+    return {
+        ...baseBundle,
+        ...overrides,
+        dataSpecs: overrides.dataSpecs ?? baseBundle.dataSpecs,
+    };
+}
+function createDivergentBundle(overrides = {}) {
+    const divergent = {
+        bundleId: 'divergent-bundle-001',
+        claim: 'Revenue is $1.0M',
+        thresholdPct: 0.05,
+        dataSpecs: [
+            {
+                id: 'source-a',
+                label: 'Source A',
+                sourceKind: 'report',
+                originDocIds: ['doc-a'],
+                metrics: [{ key: 'revenue', value: 0 }],
+            },
+            {
+                id: 'source-b',
+                label: 'Source B',
+                sourceKind: 'report',
+                originDocIds: ['doc-b'],
+                metrics: [{ key: 'revenue', value: 1000000 }],
+            },
+        ],
+    };
+    return {
+        ...divergent,
+        ...overrides,
+        dataSpecs: overrides.dataSpecs ?? divergent.dataSpecs,
+    };
+}
+//# sourceMappingURL=bundles.js.map

package/dist/__tests__/fixtures/bundles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundles.js","sourceRoot":"","sources":["../../../src/__tests__/fixtures/bundles.ts"],"names":[],"mappings":";;AAsCA,4CAMC;AAED,sDA8BC;AA1ED,MAAM,UAAU,GAAgB;IAC9B,QAAQ,EAAE,iBAAiB;IAC3B,KAAK,EAAE,mCAAmC;IAC1C,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE;QACT;YACE,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,QAAQ;YACpB,YAAY,EAAE,CAAC,OAAO,CAAC;YACvB,OAAO,EAAE;gBACP;oBACE,GAAG,EAAE,SAAS;oBACd,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,KAAK;oBACX,EAAE,EAAE,sBAAsB;iBAC3B;aACF;SACF;QACD;YACE,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,QAAQ;YACpB,YAAY,EAAE,CAAC,OAAO,CAAC;YACvB,OAAO,EAAE;gBACP;oBACE,GAAG,EAAE,SAAS;oBACd,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,KAAK;oBACX,EAAE,EAAE,sBAAsB;iBAC3B;aACF;SACF;KACF;CACF,CAAC;AAEF,SAAgB,gBAAgB,CAAC,YAAkC,EAAE;IACnE,OAAO;QACL,GAAG,UAAU;QACb,GAAG,SAAS;QACZ,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS;KACvD,CAAC;AACJ,CAAC;AAED,SAAgB,qBAAqB,CACnC,YAAkC,EAAE;IAEpC,MAAM,SAAS,GAAgB;QAC7B,QAAQ,EAAE,sBAAsB;QAChC,KAAK,EAAE,kBAAkB;QACzB,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE;YACT;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,UAAU;gBACjB,UAAU,EAAE,QAAQ;gBACpB,YAAY,EAAE,CAAC,OAAO,CAAC;gBACvB,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;aACxC;YACD;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,UAAU;gBACjB,UAAU,EAAE,QAAQ;gBACpB,YAAY,EAAE,CAAC,OAAO,CAAC;gBACvB,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;aAC9C;SACF;KACF,CAAC;IAEF,OAAO;QACL,GAAG,SAAS;QACZ,GAAG,SAAS;QACZ,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS;KACtD,CAAC;AACJ,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Configuration Management
+ * Loads configuration from environment variables
+ */
+import { ServerConfig } from './types';
+export declare function loadConfig(): ServerConfig;
+export declare const config: ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,wBAAgB,UAAU,IAAI,YAAY,CAiBzC;AAED,eAAO,MAAM,MAAM,cAAe,CAAC"}

package/dist/config.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Configuration Management
+ * Loads configuration from environment variables
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+exports.loadConfig = loadConfig;
+function loadConfig() {
+    const logLevel = (process.env.LOG_LEVEL || 'info');
+    // Validate log level
+    const validLevels = ['debug', 'info', 'warn', 'error'];
+    if (!validLevels.includes(logLevel)) {
+        throw new Error(`Invalid LOG_LEVEL: ${logLevel}. Must be one of: ${validLevels.join(', ')}`);
+    }
+    return {
+        logLevel,
+        storagePath: process.env.STORAGE_PATH,
+        maxBundleSize: process.env.MAX_BUNDLE_SIZE
+            ? parseInt(process.env.MAX_BUNDLE_SIZE, 10)
+            : 10485760, // 10MB default
+        verboseErrors: process.env.VERBOSE_ERRORS === 'true',
+    };
+}
+exports.config = loadConfig();
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,gCAiBC;AAjBD,SAAgB,UAAU;IACxB,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAA6B,CAAC;IAE/E,qBAAqB;IACrB,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,qBAAqB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO;QACL,QAAQ;QACR,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;QACrC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;YACxC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC;YAC3C,CAAC,CAAC,QAAQ,EAAE,eAAe;QAC7B,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM;KACrD,CAAC;AACJ,CAAC;AAEY,QAAA,MAAM,GAAG,UAAU,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Delta Engine MCP Server
+ * Entry point for the Model Context Protocol server
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Delta Engine MCP Server
+ * Entry point for the Model Context Protocol server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_js_1 = require("./server.js");
+const logger_js_1 = require("./logger.js");
+// Handle process termination
+process.on('SIGINT', () => {
+    logger_js_1.logger.info('Received SIGINT, shutting down gracefully...');
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    logger_js_1.logger.info('Received SIGTERM, shutting down gracefully...');
+    process.exit(0);
+});
+// Handle uncaught errors
+process.on('uncaughtException', (error) => {
+    logger_js_1.logger.error('Uncaught exception:', error);
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason) => {
+    logger_js_1.logger.error('Unhandled rejection:', reason);
+    process.exit(1);
+});
+// Start the server
+(0, server_js_1.startServer)().catch((error) => {
+    logger_js_1.logger.error('Failed to start server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;GAGG;;AAEH,2CAA0C;AAC1C,2CAAqC;AAErC,6BAA6B;AAC7B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,kBAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,kBAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,yBAAyB;AACzB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,kBAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,kBAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,mBAAmB;AACnB,IAAA,uBAAW,GAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,kBAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Simple Logger for MCP Server
+ * Respects LOG_LEVEL configuration
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+declare class Logger {
+    private level;
+    constructor(levelName?: LogLevel);
+    private shouldLog;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AASpD,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAS;gBAEV,SAAS,GAAE,QAAiB;IAIxC,OAAO,CAAC,SAAS;IAIjB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKjD;AAED,eAAO,MAAM,MAAM,QAA8B,CAAC"}

package/dist/logger.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Simple Logger for MCP Server
+ * Respects LOG_LEVEL configuration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const config_1 = require("./config");
+const levels = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+class Logger {
+    level;
+    constructor(levelName = 'info') {
+        this.level = levels[levelName];
+    }
+    shouldLog(level) {
+        return levels[level] >= this.level;
+    }
+    debug(message, ...args) {
+        if (this.shouldLog('debug')) {
+            console.error('[DEBUG]', message, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.shouldLog('info')) {
+            console.error('[INFO]', message, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.shouldLog('warn')) {
+            console.warn('[WARN]', message, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (this.shouldLog('error')) {
+            console.error('[ERROR]', message, ...args);
+        }
+    }
+}
+exports.logger = new Logger(config_1.config.logLevel);
+//# sourceMappingURL=logger.js.map