@inso_web/els-mcp 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Shared TypeScript types для ELS MCP-сервера.
+ *
+ * Источник истины — `error-logs-service/prisma/schema.prisma` (model ErrorLog).
+ * Здесь хранятся плоские DTO, удобные для MCP-tool responses.
+ */
+export type ErrorLevel = 'CRITICAL' | 'ERROR' | 'WARNING' | 'INFO' | 'DEBUG';
+export type ErrorSource = 'CLIENT' | 'SERVER';
+/**
+ * ErrorLog в API-формате (как отдаёт ELS endpoint `GET /errors`).
+ *
+ * Все timestamp'ы — ISO-8601 strings (после `.toISOString()` на стороне ELS).
+ * Опциональные поля приходят как null или отсутствуют.
+ */
+export interface ErrorLog {
+    id: string;
+    traceId: string;
+    message: string;
+    stack: string | null;
+    componentStack: string | null;
+    url: string;
+    timestamp: string;
+    receivedAt: string;
+    level: ErrorLevel | string;
+    source: ErrorSource | string;
+    browser: string;
+    urlPath: string;
+    errorCategory: string;
+    appSlug: string;
+    serviceName: string;
+    deploymentEnv: string;
+    userAgent: string;
+    language: string | null;
+    screenSize: string | null;
+    viewportSize: string | null;
+    referrer: string | null;
+    ip: string;
+    fingerprint: string | null;
+    sessionId: string | null;
+    appVersion: string | null;
+    httpStatus?: number | null;
+    durationMs?: number | null;
+    aiDiagnosis?: unknown;
+}
+/**
+ * Compact-вариант (response_format=compact): без stack/componentStack/userAgent,
+ * message ≤ 200ch.
+ */
+export interface ErrorLogCompact {
+    traceId: string;
+    level: string;
+    message: string;
+    serviceName: string | null;
+    url: string | null;
+    fingerprint: string | null;
+    receivedAt: string;
+}
+/**
+ * Summary-вариант (response_format=summary): минимум для ranked list.
+ */
+export interface ErrorLogSummary {
+    traceId: string;
+    message: string;
+    level: string;
+    count?: number;
+    lastSeen?: string;
+}
+export interface FacetValue {
+    value: string;
+    count: number;
+}
+export interface Facets {
+    source?: FacetValue[];
+    level?: FacetValue[];
+    browser?: FacetValue[];
+    urlPath?: FacetValue[];
+    language?: FacetValue[];
+    ip?: FacetValue[];
+    errorCategory?: FacetValue[];
+    app?: FacetValue[];
+    serviceName?: FacetValue[];
+    deploymentEnv?: FacetValue[];
+    appVersion?: FacetValue[];
+}
+export interface HistogramBucket {
+    ts: string;
+    count: number;
+    byLevel?: Record<string, number>;
+}
+export interface SearchLogsRawResponse {
+    items: ErrorLog[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    facets: Facets;
+    histogram: HistogramBucket[];
+}
+/**
+ * ResponseMeta — добавляется ко всем tool responses.
+ *
+ * В Phase 1 заполняем только `elsRequestId` (если ELS вернул), остальное
+ * пока хардкод (`cached:false`, без redaction). PII-redaction и cache —
+ * Phase 4/5.
+ */
+export interface ResponseMeta {
+    elsRequestId?: string | null;
+    cached: boolean;
+    ttlSec?: number;
+    redactionApplied: boolean;
+    truncated?: boolean;
+    degraded?: boolean;
+    warnings?: string[];
+}
+/**
+ * Seek-cursor payload (внутренний, base64url-кодируется).
+ *
+ * Phase 1: transitional wrapper над offset-based ELS API. Зашиваем
+ * page/limit, чтобы сохранить совместимость до момента переключения
+ * ELS на seek-based pagination (Phase 4).
+ */
+export interface CursorPayload {
+    /** ISO timestamp anchor — для seek-base в Phase 4. В Phase 1 не используется напрямую. */
+    anchorReceivedAt: string;
+    /** id записи, использованной как anchor. */
+    anchorId: string;
+    /** Хэш текущих фильтров — детект изменения filters между страницами. */
+    filtersHash: string;
+    /** Версия cursor-формата (для future migrations). */
+    v: 1;
+    /** Phase 1-only: offset-based page для backwards-compat. */
+    page?: number;
+    /** Phase 1-only: limit, чтобы сохранить размер страницы. */
+    limit?: number;
+}
+export type ResponseFormat = 'compact' | 'full' | 'summary';
+/**
+ * MCP-стандартный tool result. Совпадает по форме с CallToolResult из MCP SDK,
+ * но даёт нам типизированный shortcut в handler'ах.
+ */
+export interface ToolResult {
+    structuredContent?: Record<string, unknown>;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared TypeScript types для ELS MCP-сервера.
+ *
+ * Источник истины — `error-logs-service/prisma/schema.prisma` (model ErrorLog).
+ * Здесь хранятся плоские DTO, удобные для MCP-tool responses.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@inso_web/els-mcp",
+  "version": "0.1.0",
+  "description": "MCP-сервер поверх INSO Error Logs Service. Read-only tools (search, analytics, fingerprinting, correlations) для подключения Claude Desktop/Code и ChatGPT к логам ошибок. Streamable HTTP transport + stdio для npx-запуска.",
+  "homepage": "https://mcp.insoweb.ru/els/",
+  "author": "INSOWEB",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "els-mcp": "dist/cli.js"
+  },
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./cli": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "prisma:generate": "prisma generate --schema=prisma/schema.prisma",
+    "prisma:format": "prisma format --schema=prisma/schema.prisma"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "chatgpt",
+    "llm",
+    "ai-agent",
+    "error-tracking",
+    "error-monitoring",
+    "observability",
+    "logging",
+    "log-search",
+    "stdio",
+    "streamable-http",
+    "oauth",
+    "oidc",
+    "els",
+    "inso",
+    "insoweb"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/auto-instrumentations-node": "^0.76.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",
+    "@opentelemetry/resources": "^2.7.1",
+    "@opentelemetry/sdk-node": "^0.218.0",
+    "@prisma/client": "^6.19.3",
+    "cors": "^2.8.6",
+    "express": "^5.2.1",
+    "helmet": "^8.1.0",
+    "ioredis": "^5.10.1",
+    "jose": "^6.2.3",
+    "pako": "^2.1.0",
+    "pino": "^9.0.0",
+    "prisma": "^6.19.3",
+    "prom-client": "^15.1.3",
+    "undici": "^7.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.0.0",
+    "@types/pako": "^2.0.4",
+    "@types/supertest": "^7.2.0",
+    "ioredis-mock": "^8.13.1",
+    "pino-pretty": "^13.1.3",
+    "supertest": "^7.2.2",
+    "tsx": "^4.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  }
+}