gitlab-docs-mcp 1.0.0

package/dist/utils/logger.js

@@ -0,0 +1,44 @@
+/**
+ * Logging utility for MCP server
+ * Provides structured logging with levels
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["SILENT"] = 4] = "SILENT";
+})(LogLevel || (LogLevel = {}));
+class Logger {
+    level;
+    constructor(level = LogLevel.INFO) {
+        this.level = level;
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    debug(message, ...args) {
+        if (this.level <= LogLevel.DEBUG) {
+            console.error('[DEBUG]', message, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.level <= LogLevel.INFO) {
+            console.error('[INFO]', message, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.level <= LogLevel.WARN) {
+            console.error('[WARN]', message, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (this.level <= LogLevel.ERROR) {
+            console.error('[ERROR]', message, ...args);
+        }
+    }
+}
+// Singleton instance
+export const logger = new Logger(process.env.LOG_LEVEL ? parseInt(process.env.LOG_LEVEL) : LogLevel.INFO);
+//# 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":"AAAA;;;GAGG;AAEH,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,2CAAU,CAAA;AACZ,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AAED,MAAM,MAAM;IACF,KAAK,CAAW;IAExB,YAAY,QAAkB,QAAQ,CAAC,IAAI;QACzC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;CACF;AAED,qBAAqB;AACrB,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,CAC9B,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CACxE,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../src/utils/logger.test.ts"],"names":[],"mappings":""}

package/dist/utils/logger.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { logger, LogLevel } from '../utils/logger.js';
+describe('Logger', () => {
+    let consoleErrorSpy;
+    beforeEach(() => {
+        consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+        logger.setLevel(LogLevel.DEBUG);
+    });
+    afterEach(() => {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+        consoleErrorSpy.mockRestore();
+    });
+    describe('debug', () => {
+        it('should log when level is DEBUG', () => {
+            logger.setLevel(LogLevel.DEBUG);
+            logger.debug('Test message');
+            expect(consoleErrorSpy).toHaveBeenCalledWith('[DEBUG]', 'Test message');
+        });
+        it('should not log when level is INFO', () => {
+            logger.setLevel(LogLevel.INFO);
+            logger.debug('Test message');
+            expect(consoleErrorSpy).not.toHaveBeenCalled();
+        });
+    });
+    describe('info', () => {
+        it('should log when level is INFO', () => {
+            logger.setLevel(LogLevel.INFO);
+            logger.info('Test message');
+            expect(consoleErrorSpy).toHaveBeenCalledWith('[INFO]', 'Test message');
+        });
+        it('should not log when level is WARN', () => {
+            logger.setLevel(LogLevel.WARN);
+            logger.info('Test message');
+            expect(consoleErrorSpy).not.toHaveBeenCalled();
+        });
+    });
+    describe('warn', () => {
+        it('should log when level is WARN', () => {
+            logger.setLevel(LogLevel.WARN);
+            logger.warn('Test message');
+            expect(consoleErrorSpy).toHaveBeenCalledWith('[WARN]', 'Test message');
+        });
+        it('should not log when level is ERROR', () => {
+            logger.setLevel(LogLevel.ERROR);
+            logger.warn('Test message');
+            expect(consoleErrorSpy).not.toHaveBeenCalled();
+        });
+    });
+    describe('error', () => {
+        it('should log when level is ERROR', () => {
+            logger.setLevel(LogLevel.ERROR);
+            logger.error('Test message');
+            expect(consoleErrorSpy).toHaveBeenCalledWith('[ERROR]', 'Test message');
+        });
+        it('should not log when level is SILENT', () => {
+            logger.setLevel(LogLevel.SILENT);
+            logger.error('Test message');
+            expect(consoleErrorSpy).not.toHaveBeenCalled();
+        });
+    });
+    describe('setLevel', () => {
+        it('should change logging level', () => {
+            logger.setLevel(LogLevel.ERROR);
+            logger.info('Should not log');
+            expect(consoleErrorSpy).not.toHaveBeenCalled();
+            logger.error('Should log');
+            expect(consoleErrorSpy).toHaveBeenCalledWith('[ERROR]', 'Should log');
+        });
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/dist/utils/logger.test.js.map

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

package/dist/utils/performance.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Simple performance monitoring utilities
+ */
+export interface PerformanceMetrics {
+    operation: string;
+    durationMs: number;
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
+}
+declare class PerformanceMonitor {
+    private metrics;
+    private maxMetrics;
+    /**
+     * Measure the execution time of an async operation
+     */
+    measure<T>(operation: string, fn: () => Promise<T>, metadata?: Record<string, unknown>): Promise<T>;
+    /**
+     * Measure synchronous operation
+     */
+    measureSync<T>(operation: string, fn: () => T, metadata?: Record<string, unknown>): T;
+    /**
+     * Record a metric
+     */
+    private recordMetric;
+    /**
+     * Get metrics for a specific operation
+     */
+    getMetricsFor(operation: string): PerformanceMetrics[];
+    /**
+     * Get average duration for an operation
+     */
+    getAverageDuration(operation: string): number;
+    /**
+     * Get all metrics
+     */
+    getAllMetrics(): PerformanceMetrics[];
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+    /**
+     * Get summary statistics
+     */
+    getSummary(): Record<string, {
+        count: number;
+        avgMs: number;
+        minMs: number;
+        maxMs: number;
+    }>;
+}
+export declare const performanceMonitor: PerformanceMonitor;
+export {};
+//# sourceMappingURL=performance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/utils/performance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,cAAM,kBAAkB;IACtB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,UAAU,CAAQ;IAE1B;;OAEG;IACG,OAAO,CAAC,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC;IA0Bb;;OAEG;IACH,WAAW,CAAC,CAAC,EACX,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,CAAC,EACX,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,CAAC;IA0BJ;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAItD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAU7C;;OAEG;IACH,aAAa,IAAI,kBAAkB,EAAE;IAIrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CA4B7F;AAGD,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/utils/performance.js

@@ -0,0 +1,130 @@
+/**
+ * Simple performance monitoring utilities
+ */
+class PerformanceMonitor {
+    metrics = [];
+    maxMetrics = 1000; // Keep last 1000 metrics
+    /**
+     * Measure the execution time of an async operation
+     */
+    async measure(operation, fn, metadata) {
+        const start = performance.now();
+        try {
+            const result = await fn();
+            const durationMs = performance.now() - start;
+            this.recordMetric({
+                operation,
+                durationMs,
+                timestamp: new Date(),
+                metadata,
+            });
+            return result;
+        }
+        catch (error) {
+            const durationMs = performance.now() - start;
+            this.recordMetric({
+                operation,
+                durationMs,
+                timestamp: new Date(),
+                metadata: { ...metadata, error: true },
+            });
+            throw error;
+        }
+    }
+    /**
+     * Measure synchronous operation
+     */
+    measureSync(operation, fn, metadata) {
+        const start = performance.now();
+        try {
+            const result = fn();
+            const durationMs = performance.now() - start;
+            this.recordMetric({
+                operation,
+                durationMs,
+                timestamp: new Date(),
+                metadata,
+            });
+            return result;
+        }
+        catch (error) {
+            const durationMs = performance.now() - start;
+            this.recordMetric({
+                operation,
+                durationMs,
+                timestamp: new Date(),
+                metadata: { ...metadata, error: true },
+            });
+            throw error;
+        }
+    }
+    /**
+     * Record a metric
+     */
+    recordMetric(metric) {
+        this.metrics.push(metric);
+        // Keep only the last N metrics
+        if (this.metrics.length > this.maxMetrics) {
+            this.metrics.shift();
+        }
+    }
+    /**
+     * Get metrics for a specific operation
+     */
+    getMetricsFor(operation) {
+        return this.metrics.filter((m) => m.operation === operation);
+    }
+    /**
+     * Get average duration for an operation
+     */
+    getAverageDuration(operation) {
+        const metrics = this.getMetricsFor(operation);
+        if (metrics.length === 0) {
+            return 0;
+        }
+        const sum = metrics.reduce((acc, m) => acc + m.durationMs, 0);
+        return sum / metrics.length;
+    }
+    /**
+     * Get all metrics
+     */
+    getAllMetrics() {
+        return [...this.metrics];
+    }
+    /**
+     * Clear all metrics
+     */
+    clear() {
+        this.metrics = [];
+    }
+    /**
+     * Get summary statistics
+     */
+    getSummary() {
+        const summary = {};
+        for (const metric of this.metrics) {
+            if (!summary[metric.operation]) {
+                summary[metric.operation] = {
+                    count: 0,
+                    avgMs: 0,
+                    minMs: Infinity,
+                    maxMs: -Infinity,
+                };
+            }
+            const stats = summary[metric.operation];
+            stats.count++;
+            stats.minMs = Math.min(stats.minMs, metric.durationMs);
+            stats.maxMs = Math.max(stats.maxMs, metric.durationMs);
+        }
+        // Calculate averages
+        for (const operation in summary) {
+            const metrics = this.getMetricsFor(operation);
+            const sum = metrics.reduce((acc, m) => acc + m.durationMs, 0);
+            summary[operation].avgMs = sum / metrics.length;
+        }
+        return summary;
+    }
+}
+// Singleton instance
+export const performanceMonitor = new PerformanceMonitor();
+//# sourceMappingURL=performance.js.map

package/dist/utils/performance.js.map

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

package/dist/utils/performance.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=performance.test.d.ts.map

package/dist/utils/performance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.test.d.ts","sourceRoot":"","sources":["../../src/utils/performance.test.ts"],"names":[],"mappings":""}

package/dist/utils/performance.test.js

@@ -0,0 +1,75 @@
+import { describe, it, expect } from 'vitest';
+import { performanceMonitor } from './performance.js';
+describe('PerformanceMonitor', () => {
+    it('should measure async operations', async () => {
+        const result = await performanceMonitor.measure('test-async', async () => {
+            await new Promise((resolve) => setTimeout(resolve, 10));
+            return 'success';
+        });
+        expect(result).toBe('success');
+        const metrics = performanceMonitor.getMetricsFor('test-async');
+        expect(metrics.length).toBeGreaterThan(0);
+        expect(metrics[0].operation).toBe('test-async');
+        expect(metrics[0].durationMs).toBeGreaterThan(0);
+    });
+    it('should measure sync operations', () => {
+        const result = performanceMonitor.measureSync('test-sync', () => {
+            let sum = 0;
+            for (let i = 0; i < 1000; i++) {
+                sum += i;
+            }
+            return sum;
+        });
+        expect(result).toBe(499500);
+        const metrics = performanceMonitor.getMetricsFor('test-sync');
+        expect(metrics.length).toBeGreaterThan(0);
+        expect(metrics[0].operation).toBe('test-sync');
+    });
+    it('should calculate average duration', async () => {
+        performanceMonitor.clear();
+        await performanceMonitor.measure('avg-test', async () => {
+            await new Promise((resolve) => setTimeout(resolve, 5));
+        });
+        await performanceMonitor.measure('avg-test', async () => {
+            await new Promise((resolve) => setTimeout(resolve, 15));
+        });
+        const avgDuration = performanceMonitor.getAverageDuration('avg-test');
+        expect(avgDuration).toBeGreaterThan(0);
+    });
+    it('should track metadata', () => {
+        performanceMonitor.clear();
+        performanceMonitor.measureSync('metadata-test', () => {
+            return 'result';
+        }, { userId: 'test-user', operation: 'search' });
+        const metrics = performanceMonitor.getMetricsFor('metadata-test');
+        expect(metrics[0].metadata).toEqual({ userId: 'test-user', operation: 'search' });
+    });
+    it('should handle errors and track them', async () => {
+        performanceMonitor.clear();
+        await expect(performanceMonitor.measure('error-test', () => {
+            throw new Error('Test error');
+        })).rejects.toThrow('Test error');
+        const metrics = performanceMonitor.getMetricsFor('error-test');
+        expect(metrics[0].metadata?.error).toBe(true);
+    });
+    it('should generate summary statistics', async () => {
+        performanceMonitor.clear();
+        await performanceMonitor.measure('summary-test', async () => { });
+        await performanceMonitor.measure('summary-test', async () => { });
+        await performanceMonitor.measure('other-test', async () => { });
+        const summary = performanceMonitor.getSummary();
+        expect(summary['summary-test']).toBeDefined();
+        expect(summary['summary-test'].count).toBe(2);
+        expect(summary['summary-test'].avgMs).toBeGreaterThanOrEqual(0);
+        expect(summary['summary-test'].minMs).toBeGreaterThanOrEqual(0);
+        expect(summary['summary-test'].maxMs).toBeGreaterThanOrEqual(0);
+        expect(summary['other-test']).toBeDefined();
+        expect(summary['other-test'].count).toBe(1);
+    });
+    it('should clear all metrics', () => {
+        performanceMonitor.clear();
+        const metrics = performanceMonitor.getAllMetrics();
+        expect(metrics.length).toBe(0);
+    });
+});
+//# sourceMappingURL=performance.test.js.map

package/dist/utils/performance.test.js.map

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

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "gitlab-docs-mcp",
+  "version": "1.0.0",
+  "author": "Ozan Mutlu",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ozanmutlu/Gitlab-Docs-MCP.git"
+  },
+  "description": "GitLab documentation search for AI assistants via Model Context Protocol (MCP)",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "gitlab-docs-mcp": "./dist/bin.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "dev": "tsx src/index.ts",
+    "build-index": "tsx scripts/build-index.ts",
+    "prepare": "npm run build",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "test:watch": "vitest --watch",
+    "lint": "eslint src --max-warnings 0",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"scripts/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"scripts/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist coverage",
+    "validate": "npm run typecheck && npm run lint && npm run test"
+  },
+  "keywords": [
+    "gitlab",
+    "mcp",
+    "model-context-protocol",
+    "ai-assistant",
+    "documentation",
+    "search",
+    "claude",
+    "copilot"
+  ],
+  "files": [
+    "dist/",
+    "data/gitlab-docs/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.3",
+    "dotenv": "^17.2.3",
+    "flexsearch": "^0.8.212",
+    "lru-cache": "^11.2.4",
+    "remark": "^15.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-stringify": "^11.0.0",
+    "unified": "^11.0.5",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
+    "@vitest/coverage-v8": "^4.0.15",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
+    "prettier": "^3.7.4",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.48.1",
+    "vitest": "^4.0.15"
+  }
+}