mcp-rubber-duck 1.1.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,3 @@
+import winston from 'winston';
+export declare const logger: winston.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAkE9B,eAAO,MAAM,MAAM,gBAcjB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,86 @@
+import winston from 'winston';
+import { existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+const logLevel = process.env.LOG_LEVEL || 'info';
+const isMCP = process.env.MCP_SERVER === 'true' || process.argv.includes('--mcp');
+// Determine logs directory based on environment and execution context
+function getLogsDirectory() {
+    // Allow custom logs directory via environment variable
+    if (process.env.LOGS_DIR) {
+        return process.env.LOGS_DIR;
+    }
+    try {
+        // Try to use project directory when possible (development/direct execution)
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const projectRoot = join(__dirname, '..', '..');
+        const projectLogsDir = join(projectRoot, 'logs');
+        // Check if we can write to project directory
+        if (existsSync(projectRoot)) {
+            return projectLogsDir;
+        }
+    }
+    catch (error) {
+        // Fall through to user directory if project root detection fails
+    }
+    // Fallback to user directory for MCP server or when project root isn't writable
+    return join(homedir(), '.mcp-rubber-duck', 'logs');
+}
+// Ensure logs directory exists
+const logsDir = getLogsDirectory();
+if (!existsSync(logsDir)) {
+    mkdirSync(logsDir, { recursive: true });
+}
+// Use simpler format for MCP to avoid interfering with JSON communication
+const consoleFormat = isMCP
+    ? winston.format.simple()
+    : winston.format.combine(winston.format.colorize(), winston.format.simple());
+// File format with more details for debugging crashes
+const fileFormat = winston.format.combine(winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston.format.errors({ stack: true }), winston.format.splat(), winston.format.printf(({ timestamp, level, message, stack, ...meta }) => {
+    let log = `${String(timestamp)} [${String(level).toUpperCase()}]: ${String(message)}`;
+    if (stack && typeof stack === 'string') {
+        log += `\nStack: ${stack}`;
+    }
+    if (Object.keys(meta).length > 0) {
+        log += `\nMeta: ${JSON.stringify(meta, null, 2)}`;
+    }
+    return log;
+}));
+export const logger = winston.createLogger({
+    level: logLevel,
+    format: winston.format.combine(winston.format.timestamp(), winston.format.errors({ stack: true }), winston.format.splat(), winston.format.json()),
+    transports: [
+        new winston.transports.Console({
+            format: consoleFormat,
+            silent: isMCP, // Always silence console logs in MCP mode to avoid interfering with JSON-RPC
+        }),
+    ],
+});
+// Always add file logging for better crash diagnosis
+const filePrefix = isMCP ? 'mcp' : 'server';
+// Error log
+logger.add(new winston.transports.File({
+    filename: join(logsDir, `${filePrefix}-error.log`),
+    level: 'error',
+    format: fileFormat,
+    maxsize: 10 * 1024 * 1024, // 10MB
+    maxFiles: 5,
+}));
+// Combined log
+logger.add(new winston.transports.File({
+    filename: join(logsDir, `${filePrefix}-combined.log`),
+    format: fileFormat,
+    maxsize: 50 * 1024 * 1024, // 50MB
+    maxFiles: 3,
+}));
+// Crash log for fatal errors
+logger.add(new winston.transports.File({
+    filename: join(logsDir, `${filePrefix}-crash.log`),
+    level: 'error',
+    format: fileFormat,
+    maxsize: 10 * 1024 * 1024, // 10MB
+    maxFiles: 10,
+}));
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/safe-logger.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Sanitizes an object by redacting sensitive fields
+ */
+declare function sanitizeObject(obj: unknown, maxDepth?: number, currentDepth?: number): unknown;
+/**
+ * Safe logger that sanitizes sensitive data before logging
+ */
+export declare class SafeLogger {
+    static debug(message: string, data?: unknown): void;
+    static info(message: string, data?: unknown): void;
+    static warn(message: string, data?: unknown): void;
+    static error(message: string, data?: unknown): void;
+    /**
+     * Sanitize arguments object specifically for MCP tool calls
+     */
+    static sanitizeToolArgs(args: unknown): unknown;
+    /**
+     * Create a safe message for approval requests
+     */
+    static createApprovalMessage(duckName: string, server: string, tool: string, args: unknown): string;
+}
+export { sanitizeObject };
+//# sourceMappingURL=safe-logger.d.ts.map

package/dist/utils/safe-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-logger.d.ts","sourceRoot":"","sources":["../../src/utils/safe-logger.ts"],"names":[],"mappings":"AA8BA;;GAEG;AACH,iBAAS,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,SAAI,EAAE,YAAY,SAAI,GAAG,OAAO,CAkD7E;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IASnD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IASlD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IASlD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IASnD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAwB/C;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM;CAMpG;AAGD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/utils/safe-logger.js

@@ -0,0 +1,145 @@
+import { logger } from './logger.js';
+// List of fields that should be sanitized in logs
+const SENSITIVE_FIELDS = [
+    'password',
+    'apiKey',
+    'api_key',
+    'token',
+    'secret',
+    'auth',
+    'authorization',
+    'cookie',
+    'session',
+    'private_key',
+    'privateKey',
+    'client_secret',
+    'clientSecret',
+];
+// List of field patterns to look for
+const SENSITIVE_PATTERNS = [
+    /password/i,
+    /secret/i,
+    /token/i,
+    /key$/i,
+    /auth/i,
+    /cookie/i,
+    /session/i,
+];
+/**
+ * Sanitizes an object by redacting sensitive fields
+ */
+function sanitizeObject(obj, maxDepth = 5, currentDepth = 0) {
+    if (currentDepth >= maxDepth) {
+        return '[Max depth exceeded]';
+    }
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    if (typeof obj === 'string') {
+        // Check if the string looks like a sensitive value (e.g., long random strings)
+        if (obj.length > 20 && /^[a-zA-Z0-9+/=]{20,}$/.test(obj)) {
+            return `[REDACTED:${obj.length}chars]`;
+        }
+        return obj;
+    }
+    if (typeof obj === 'number' || typeof obj === 'boolean') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => sanitizeObject(item, maxDepth, currentDepth + 1));
+    }
+    if (typeof obj === 'object') {
+        const sanitized = {};
+        for (const [key, value] of Object.entries(obj)) {
+            const keyLower = key.toLowerCase();
+            // Check if the field name is sensitive
+            const isSensitive = SENSITIVE_FIELDS.includes(keyLower) ||
+                SENSITIVE_PATTERNS.some(pattern => pattern.test(key));
+            if (isSensitive) {
+                if (typeof value === 'string' && value.length > 0) {
+                    sanitized[key] = `[REDACTED:${value.length}chars]`;
+                }
+                else {
+                    sanitized[key] = '[REDACTED]';
+                }
+            }
+            else {
+                sanitized[key] = sanitizeObject(value, maxDepth, currentDepth + 1);
+            }
+        }
+        return sanitized;
+    }
+    return obj;
+}
+/**
+ * Safe logger that sanitizes sensitive data before logging
+ */
+export class SafeLogger {
+    static debug(message, data) {
+        if (data) {
+            const sanitizedData = sanitizeObject(data);
+            logger.debug(message, sanitizedData);
+        }
+        else {
+            logger.debug(message);
+        }
+    }
+    static info(message, data) {
+        if (data) {
+            const sanitizedData = sanitizeObject(data);
+            logger.info(message, sanitizedData);
+        }
+        else {
+            logger.info(message);
+        }
+    }
+    static warn(message, data) {
+        if (data) {
+            const sanitizedData = sanitizeObject(data);
+            logger.warn(message, sanitizedData);
+        }
+        else {
+            logger.warn(message);
+        }
+    }
+    static error(message, data) {
+        if (data) {
+            const sanitizedData = sanitizeObject(data);
+            logger.error(message, sanitizedData);
+        }
+        else {
+            logger.error(message);
+        }
+    }
+    /**
+     * Sanitize arguments object specifically for MCP tool calls
+     */
+    static sanitizeToolArgs(args) {
+        const sanitized = sanitizeObject(args);
+        // Additional sanitization for common patterns in tool arguments
+        if (typeof sanitized === 'object' && sanitized !== null) {
+            const objSanitized = sanitized;
+            // Sanitize file paths that might contain usernames
+            if (objSanitized.path && typeof objSanitized.path === 'string') {
+                objSanitized.path = objSanitized.path.replace(/\/Users\/[^/]+/, '/Users/[USER]');
+                objSanitized.path = objSanitized.path.replace(/\\Users\\[^\\]+/, '\\Users\\[USER]');
+            }
+            // Sanitize URLs that might contain credentials
+            if (objSanitized.url && typeof objSanitized.url === 'string') {
+                objSanitized.url = objSanitized.url.replace(/(https?:\/\/)([^:]+):([^@]+)@/, '$1[USER]:[REDACTED]@');
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Create a safe message for approval requests
+     */
+    static createApprovalMessage(duckName, server, tool, args) {
+        const sanitizedArgs = this.sanitizeToolArgs(args);
+        const argsStr = JSON.stringify(sanitizedArgs, null, 2);
+        return `Duck "${duckName}" wants to call ${server}:${tool} with arguments:\n${argsStr}`;
+    }
+}
+// Export the sanitize function for direct use
+export { sanitizeObject };
+//# sourceMappingURL=safe-logger.js.map

package/dist/utils/safe-logger.js.map

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

package/docker-compose.yml

@@ -0,0 +1,161 @@
+version: '3.8'
+
+services:
+  mcp-rubber-duck:
+    # Multi-platform Docker image (AMD64, ARM64)
+    # Works on: macOS, Linux, Windows, Raspberry Pi 3+
+    image: ${DOCKER_IMAGE:-ghcr.io/nesquikm/mcp-rubber-duck:latest}
+    container_name: mcp-rubber-duck
+    init: true
+    restart: unless-stopped
+    profiles:
+      - default
+      - lightweight
+      - desktop
+    
+    # Resource limits - adjust based on your platform
+    # Raspberry Pi: Use 'lightweight' profile (default settings below)
+    # Desktop/Server: Use 'desktop' profile with higher limits
+    deploy:
+      resources:
+        limits:
+          cpus: ${DOCKER_CPU_LIMIT:-1.5}
+          memory: ${DOCKER_MEMORY_LIMIT:-512M}
+        reservations:
+          memory: ${DOCKER_MEMORY_RESERVATION:-256M}
+    
+    # Fallback for older docker-compose versions
+    mem_limit: ${DOCKER_MEMORY_LIMIT:-512m}
+    cpus: ${DOCKER_CPU_LIMIT:-1.5}
+    
+    # Environment variables
+    environment:
+      # Node.js optimizations - adjust based on available memory
+      # Pi/lightweight: --max-old-space-size=256
+      # Desktop/server: --max-old-space-size=1024
+      - NODE_OPTIONS=${NODE_OPTIONS:---max-old-space-size=256}
+      - NODE_ENV=production
+      
+      # MCP Server configuration
+      - MCP_SERVER=true
+      
+      # Logging
+      - LOG_LEVEL=${LOG_LEVEL:-info}
+      
+      # Provider configuration
+      - DEFAULT_PROVIDER=${DEFAULT_PROVIDER:-openai}
+      - DEFAULT_TEMPERATURE=${DEFAULT_TEMPERATURE:-0.7}
+      
+      # OpenAI Provider
+      - OPENAI_API_KEY=${OPENAI_API_KEY}
+      - OPENAI_DEFAULT_MODEL=${OPENAI_DEFAULT_MODEL:-gpt-4o-mini}
+      
+      # Google Gemini Provider
+      - GEMINI_API_KEY=${GEMINI_API_KEY}
+      - GEMINI_DEFAULT_MODEL=${GEMINI_DEFAULT_MODEL:-gemini-2.5-flash}
+      
+      # Groq Provider
+      - GROQ_API_KEY=${GROQ_API_KEY}
+      - GROQ_DEFAULT_MODEL=${GROQ_DEFAULT_MODEL:-llama-3.3-70b-versatile}
+      
+      # Together AI Provider
+      - TOGETHER_API_KEY=${TOGETHER_API_KEY}
+      
+      # Perplexity Provider
+      - PERPLEXITY_API_KEY=${PERPLEXITY_API_KEY}
+      
+      # Ollama (Local AI - requires 'with-ollama' profile)
+      - OLLAMA_BASE_URL=${OLLAMA_BASE_URL:-http://ollama:11434/v1}
+      - OLLAMA_DEFAULT_MODEL=${OLLAMA_DEFAULT_MODEL:-llama3.2}
+      
+      # Custom providers (you can add multiple)
+      - CUSTOM_API_KEY=${CUSTOM_API_KEY}
+      - CUSTOM_BASE_URL=${CUSTOM_BASE_URL}
+      - CUSTOM_DEFAULT_MODEL=${CUSTOM_DEFAULT_MODEL}
+      
+      # MCP Bridge Settings (Optional)
+      - MCP_BRIDGE_ENABLED=${MCP_BRIDGE_ENABLED:-false}
+      - MCP_APPROVAL_MODE=${MCP_APPROVAL_MODE:-trusted}
+      - MCP_APPROVAL_TIMEOUT=${MCP_APPROVAL_TIMEOUT:-300}
+      
+    # Volume mounts for persistent data and configuration
+    volumes:
+      # Mount config directory (read-only)
+      - ./config:/app/config:ro
+      # Mount data directory for logs and cache
+      - ./data:/app/data
+      # Optional: Mount custom .env file
+      - ./.env:/app/.env:ro
+      
+    # For MCP stdio communication
+    stdin_open: true
+    tty: true
+    
+    # Logging configuration to prevent disk space issues
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+        
+    # Health check configuration
+    healthcheck:
+      test: ["CMD", "node", "-e", "process.exit(0)"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 30s
+      
+    # Network configuration (optional)
+    # ports:
+    #   - "3000:3000"  # Only uncomment if you need HTTP access
+      
+  # Optional: Local Ollama service (works on all platforms)
+  # Enable with: docker-compose --profile with-ollama up -d
+  ollama:
+    image: ollama/ollama:latest
+    container_name: ollama
+    restart: unless-stopped
+    profiles:
+      - with-ollama
+    
+    # Resource limits - adjust based on your platform
+    # Pi: Use default settings below (1GB limit)
+    # Desktop: Increase memory for better performance
+    deploy:
+      resources:
+        limits:
+          cpus: ${OLLAMA_CPU_LIMIT:-2.0}
+          memory: ${OLLAMA_MEMORY_LIMIT:-1G}
+        reservations:
+          memory: ${OLLAMA_MEMORY_RESERVATION:-512M}
+    
+    # Fallback for older docker-compose versions
+    mem_limit: ${OLLAMA_MEMORY_LIMIT:-1g}
+    cpus: ${OLLAMA_CPU_LIMIT:-2.0}
+    
+    ports:
+      - "11434:11434"
+      
+    volumes:
+      - ollama_data:/root/.ollama
+      
+    # Environment for ARM optimization
+    environment:
+      - OLLAMA_HOST=0.0.0.0
+      - OLLAMA_ORIGINS=*
+      
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "20m"
+        max-file: "3"
+
+volumes:
+  ollama_data:
+    driver: local
+
+# Networks (optional)
+networks:
+  default:
+    name: mcp-rubber-duck-network

package/jest.config.js

@@ -0,0 +1,26 @@
+/** @type {import('jest').Config} */
+export default {
+  preset: 'ts-jest/presets/default-esm',
+  testEnvironment: 'node',
+  extensionsToTreatAsEsm: ['.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        useESM: true,
+      },
+    ],
+  },
+  testMatch: ['**/tests/**/*.test.ts'],
+  collectCoverage: true,
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/index.ts',
+  ],
+};

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "mcp-rubber-duck",
+  "version": "1.1.0",
+  "description": "An MCP server that bridges to multiple OpenAI-compatible LLMs - your AI rubber duck debugging panel",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "mcp-rubber-duck": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
+    "test:watch": "NODE_OPTIONS='--experimental-vm-modules' jest --watch",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "release": "semantic-release"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "llm",
+    "openai",
+    "ai",
+    "rubber-duck"
+  ],
+  "mcpName": "io.github.nesquikm.rubber-duck",
+  "author": "nesquikm",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nesquikm/mcp-rubber-duck.git"
+  },
+  "homepage": "https://github.com/nesquikm/mcp-rubber-duck#readme",
+  "bugs": {
+    "url": "https://github.com/nesquikm/mcp-rubber-duck/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ajv": "^8.17.1",
+    "dotenv": "^16.4.0",
+    "node-cache": "^5.1.2",
+    "openai": "^4.0.0",
+    "winston": "^3.11.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.6",
+    "@types/jest": "^29.0.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0",
+    "prettier": "^3.0.0",
+    "semantic-release": "^24.2.8",
+    "ts-jest": "^29.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}