elasticsearch-mcp-vsee-stage 0.5.13

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 elastic-mcp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,304 @@
+# Elasticsearch MCP (VSee Fork)
+
+> **Modified MCP server with hardcoded schemas matching VSee's Elasticsearch indexes. Specialized analytics tools optimized for stats-* indices.**
+
+[![npm version](https://badge.fury.io/js/elasticsearch-mcp-vsee.svg)](https://www.npmjs.com/package/elasticsearch-mcp-vsee)
+[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Elasticsearch](https://img.shields.io/badge/Elasticsearch-005571?logo=elasticsearch&logoColor=white)](https://www.elastic.co/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**elasticsearch-mcp-vsee** is a modified Model Context Protocol (MCP) server that provides specialized analytics tools for Elasticsearch clusters, optimized for VSee's stats-* indices. This fork features hardcoded schemas and field names that match VSee's specific Elasticsearch index structure, enabling specialized tools for account/group analytics, visit trends, platform breakdowns, and rating distributions. Built with TypeScript and optimized for Elastic Cloud environments, it offers comprehensive analytics capabilities with enterprise-grade security features.
+
+## 🚀 Features
+
+- **🔐 Secure by Design**: Input validation, script sanitization, injection prevention
+- **☁️ Elastic Cloud Ready**: Native support for cloud ID and API key authentication  
+- **⚡ High Performance**: Connection pooling, optimized query execution, efficient aggregations
+- **🛠️ Comprehensive Tools**: 11 specialized tools for analytics, summaries, and data exploration
+- **📊 Advanced Querying**: Full Elasticsearch DSL support with aggregations and highlighting
+- **🔍 Smart Validation**: Zod-based schemas with security-first validation
+- **📝 Full TypeScript**: Complete type safety with strict null checks
+
+## 🎯 Purpose
+
+This MCP server is designed for **VSee's Open WebUI deployment** to provide specialized analytics tools for querying VSee's Elasticsearch `stats-*` indices. It integrates with VSee's Open WebUI infrastructure via MCPO (MCP OpenAPI bridge) to expose Elasticsearch analytics capabilities to LLMs.
+
+## 📦 Usage with VSee's Open WebUI Deployment
+
+This MCP server is automatically loaded by VSee's Open WebUI deployment through the MCP configuration. It connects to VSee's Elasticsearch deployment to provide analytics on visit statistics, account/group metrics, platform breakdowns, and more.
+
+### Configuration
+
+The MCP server is configured in `vsee/mcp/config.json`:
+
+```json
+{
+  "mcpServers": {
+    "elasticsearch": {
+      "command": "npx",
+      "args": ["-y", "elasticsearch-mcp-vsee"],
+      "env": {
+        "ELASTIC_NODE": "https://omtm.es.us-east-1.aws.found.io",
+        "ELASTIC_USERNAME": "your-username",
+        "ELASTIC_PASSWORD": "your-password",
+        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
+      }
+    }
+  }
+}
+```
+
+The Open WebUI deployment automatically loads this configuration and starts the MCP server via MCPO, making all 11 tools available to the LLM for querying Elasticsearch data.
+
+## 🔄 Updating and Publishing
+
+### Making Changes
+
+1. **Develop locally**: Make changes to the code in `elasticsearch-mcp/`
+2. **Test your changes**: Use `npm run test:tools` to test against your Elasticsearch instance
+3. **Build**: Run `npm run build` to compile TypeScript
+4. **Publish**: Publish to npm with `npm publish --access public`
+   - Make sure to increment the version in `package.json` first
+
+### Updating VSee's Deployment
+
+After publishing a new version to npm:
+
+1. **Update `vsee/mcp/config.json`**: Change the package version in the `args` array:
+   ```json
+   {
+     "mcpServers": {
+       "elasticsearch": {
+         "command": "npx",
+         "args": ["-y", "elasticsearch-mcp-vsee@0.5.0"],  // Update version here
+         "env": {
+           ...
+         }
+       }
+     }
+   }
+   ```
+
+2. **Restart the MCPO service**: The MCPO container will automatically download and use the new version on restart:
+   ```bash
+   docker compose -f docker-compose.vsee.yaml restart mcpo
+   ```
+
+3. **Verify**: Check that the new version is loaded by examining the MCPO logs or testing the tools in Open WebUI.
+
+**Note**: You can also use `@latest` to always pull the latest version, but specifying a version number is recommended for production stability.
+
+## 🛠️ Available Tools
+
+| Tool | Description | Use Cases |
+|------|-------------|-----------|
+| `get_index_fields` | Discover index fields and types | Schema exploration, field discovery |
+| `top_change` | Find top accounts or groups with highest visit increase/decrease | Trend analysis, account/group monitoring |
+| `get_subscription_breakdown` | Compare subscription tiers with metrics per tier | Subscription-tier analysis and comparisons |
+| `get_platform_breakdown` | Platform or platform version breakdown (provider/patient, platform/version) | Platform adoption, device preferences, version analysis |
+| `get_rating_distribution` | Rating histograms with statistics | Satisfaction analysis |
+| `get_visit_trends` | Time series visit trends (daily/weekly/monthly) | Trend visualization |
+| `get_usage_summary` | Comprehensive metrics summary with flexible filtering and grouping | Multi-dimensional analysis and comparisons |
+
+## 📋 Tool Examples
+
+### Get Account Summary
+
+```json
+{
+  "tool": "get_account_summary",
+  "arguments": {
+    "account": "example-customer",
+    "startDate": "now-1y",
+    "endDate": "now"
+  }
+}
+```
+
+### Get Top Accounts by Growth
+
+```json
+{
+  "tool": "top_change",
+  "arguments": {
+    "groupBy": "account",
+    "direction": "increase",
+    "topN": 10,
+    "currentPeriodDays": 30,
+    "previousPeriodDays": 30
+  }
+}
+```
+
+### Get Platform Breakdown
+
+```json
+{
+  "tool": "get_platform_breakdown",
+  "arguments": {
+    "role": "provider",
+    "breakdownType": "version",
+    "topN": 10,
+    "startDate": "now-30d",
+    "endDate": "now"
+  }
+}
+```
+
+### Get Visit Trends
+
+```json
+{
+  "tool": "get_visit_trends",
+  "arguments": {
+    "interval": "daily",
+    "startDate": "now-30d",
+    "endDate": "now",
+    "groupBy": "subscription"
+  }
+}
+```
+
+## ⚙️ Configuration
+
+### Environment Variables
+
+The MCP server reads configuration from environment variables. These are set in `vsee/mcp/config.json` under the `env` section:
+
+| Variable | Description | Required | Example |
+|----------|-------------|----------|---------|
+| `ELASTIC_NODE` | Elasticsearch URL | Yes | `https://omtm.es.us-east-1.aws.found.io` |
+| `ELASTIC_USERNAME` | Basic auth username | Yes | `your-username` |
+| `ELASTIC_PASSWORD` | Basic auth password | Yes | `your-password` |
+| `NODE_TLS_REJECT_UNAUTHORIZED` | Disable TLS verification (for self-signed certs) | No | `"0"` |
+
+### Alternative: Elastic Cloud Authentication
+
+If using Elastic Cloud with cloud ID and API key:
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `ELASTIC_CLOUD_ID` | Elastic Cloud deployment ID | Yes* |
+| `ELASTIC_API_KEY` | Elasticsearch API key | Yes* |
+
+*Either `ELASTIC_CLOUD_ID` + `ELASTIC_API_KEY` OR `ELASTIC_NODE` + `ELASTIC_USERNAME` + `ELASTIC_PASSWORD` is required
+
+## 🔒 Security Features
+
+### Input Validation
+- **Zod Schemas**: Strict type validation for all inputs
+- **Field Name Validation**: Prevents reserved field usage
+- **Size Limits**: Document size, array length, string length limits
+- **Depth Validation**: Prevents deeply nested objects/queries
+
+### Script Security
+- **Script Sanitization**: Blocks dangerous script patterns
+- **Parameter Validation**: Validates script parameters
+- **Execution Limits**: Prevents resource exhaustion
+
+### Query Security
+- **Injection Prevention**: Sanitizes and validates all queries
+- **Script Query Blocking**: Prevents script-based queries in sensitive operations
+- **Rate Limiting**: Protects against abuse
+
+### Data Protection
+- **Credential Masking**: Never logs sensitive information
+- **Secure Connections**: TLS/SSL support
+- **Access Control**: Validates permissions before operations
+
+## 🏗️ Architecture
+
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   MCP Client    │◄──►│Elasticsearch MCP│◄──►│  Elasticsearch  │
+│  (Claude, etc.) │    │     Server      │    │    Cluster      │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+                              │
+                       ┌─────────────┐
+                       │   Tools     │
+                       │             │
+                       │ • search    │
+                       │ • fields    │
+                       │ • summaries │
+                       │ • trends    │
+                       │ • analytics │
+                       └─────────────┘
+```
+
+## 📊 Performance
+
+### Benchmarks
+- **Search**: <500ms average response time
+- **Aggregations**: Optimized for large-scale analytics
+- **Memory Usage**: <100MB for typical operations
+- **Concurrent Requests**: Up to 10 simultaneous operations
+
+### Optimization Features
+- **Connection Pooling**: Reuses Elasticsearch connections
+- **Optimized Queries**: Efficient aggregation pipelines
+- **Smart Caching**: Reduced redundant queries
+- **Health Monitoring**: Automatic reconnection on failures
+
+## 🔧 Development
+
+### Setup Development Environment
+
+```bash
+# Install dependencies
+npm install
+
+# Set up environment variables
+export ELASTIC_NODE="https://your-elasticsearch-url"
+export ELASTIC_USERNAME="your-username"
+export ELASTIC_PASSWORD="your-password"
+export NODE_TLS_REJECT_UNAUTHORIZED="0"  # If needed for self-signed certs
+
+# Run in development mode
+npm run dev
+
+# Test tools against live Elasticsearch
+npm run test:tools
+
+# Build for production
+npm run build
+
+# Publish new version (after incrementing version in package.json)
+npm publish --access public
+```
+
+### Project Structure
+
+```
+elasticsearch-mcp/
+├── src/
+│   ├── tools/           # MCP tool implementations
+│   ├── elasticsearch/   # ES client and connection management
+│   ├── validation/      # Input validation schemas
+│   ├── errors/          # Error handling utilities
+│   ├── config.ts        # Configuration management
+│   ├── logger.ts        # Structured logging
+│   └── server.ts        # Main MCP server
+├── tests/               # Test suite
+└── build/               # Compiled output
+```
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🏷️ Version History
+
+- **v0.5.0** - Added `find_entities_by_metric` tool with multi-metric filtering support, updated default limits
+- **v0.4.0** - Tool consolidation: merged 14 tools into 11 specialized analytics tools
+- **v0.3.0** - Specialized analytics tools for stats-* indices
+- Full changelog: [CHANGELOG.md](CHANGELOG.md)
+
+## 🔗 Links
+
+- [npm Package](https://www.npmjs.com/package/elasticsearch-mcp-vsee)
+- [Elasticsearch Documentation](https://www.elastic.co/guide/)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+
+---
+
+**Built for VSee by VSee**

package/build/config.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+export declare const ElasticConfigSchema: z.ZodObject<{
+    cloudId: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    node: z.ZodOptional<z.ZodString>;
+    auth: z.ZodOptional<z.ZodObject<{
+        username: z.ZodString;
+        password: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        username: string;
+        password: string;
+    }, {
+        username: string;
+        password: string;
+    }>>;
+    maxRetries: z.ZodDefault<z.ZodNumber>;
+    requestTimeout: z.ZodDefault<z.ZodNumber>;
+    pingTimeout: z.ZodDefault<z.ZodNumber>;
+    sniffOnStart: z.ZodDefault<z.ZodBoolean>;
+    sniffInterval: z.ZodOptional<z.ZodNumber>;
+    ssl: z.ZodOptional<z.ZodObject<{
+        rejectUnauthorized: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        rejectUnauthorized: boolean;
+    }, {
+        rejectUnauthorized?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    maxRetries: number;
+    requestTimeout: number;
+    pingTimeout: number;
+    sniffOnStart: boolean;
+    cloudId?: string | undefined;
+    apiKey?: string | undefined;
+    node?: string | undefined;
+    auth?: {
+        username: string;
+        password: string;
+    } | undefined;
+    sniffInterval?: number | undefined;
+    ssl?: {
+        rejectUnauthorized: boolean;
+    } | undefined;
+}, {
+    cloudId?: string | undefined;
+    apiKey?: string | undefined;
+    node?: string | undefined;
+    auth?: {
+        username: string;
+        password: string;
+    } | undefined;
+    maxRetries?: number | undefined;
+    requestTimeout?: number | undefined;
+    pingTimeout?: number | undefined;
+    sniffOnStart?: boolean | undefined;
+    sniffInterval?: number | undefined;
+    ssl?: {
+        rejectUnauthorized?: boolean | undefined;
+    } | undefined;
+}>;
+export type ElasticConfig = z.infer<typeof ElasticConfigSchema>;
+export interface ServerConfig {
+    name: string;
+    version: string;
+    elasticsearch: ElasticConfig;
+    logging: {
+        level: 'error' | 'warn' | 'info' | 'debug';
+        format: 'json' | 'text';
+    };
+    server: {
+        maxConcurrentRequests: number;
+        requestTimeoutMs: number;
+    };
+}
+export declare function loadConfig(): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/build/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC3C,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;KACzB,CAAC;IACF,MAAM,EAAE;QACN,qBAAqB,EAAE,MAAM,CAAC;QAC9B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,wBAAgB,UAAU,IAAI,YAAY,CA4BzC"}

package/build/config.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElasticConfigSchema = void 0;
+exports.loadConfig = loadConfig;
+const zod_1 = require("zod");
+exports.ElasticConfigSchema = zod_1.z.object({
+    cloudId: zod_1.z.string().optional(),
+    apiKey: zod_1.z.string().optional(),
+    node: zod_1.z.string().optional(),
+    auth: zod_1.z.object({
+        username: zod_1.z.string(),
+        password: zod_1.z.string(),
+    }).optional(),
+    maxRetries: zod_1.z.number().min(0).max(10).default(3),
+    requestTimeout: zod_1.z.number().min(1000).max(300000).default(30000),
+    pingTimeout: zod_1.z.number().min(1000).max(30000).default(3000),
+    sniffOnStart: zod_1.z.boolean().default(false),
+    sniffInterval: zod_1.z.number().positive().optional(),
+    ssl: zod_1.z.object({
+        rejectUnauthorized: zod_1.z.boolean().default(true),
+    }).optional(),
+});
+function loadConfig() {
+    const config = {
+        name: 'elasticsearch-mcp',
+        version: '0.1.3',
+        elasticsearch: exports.ElasticConfigSchema.parse({
+            cloudId: process.env.ELASTIC_CLOUD_ID,
+            apiKey: process.env.ELASTIC_API_KEY,
+            node: process.env.ELASTIC_NODE,
+            auth: process.env.ELASTIC_USERNAME && process.env.ELASTIC_PASSWORD ? {
+                username: process.env.ELASTIC_USERNAME,
+                password: process.env.ELASTIC_PASSWORD,
+            } : undefined,
+            maxRetries: process.env.ELASTIC_MAX_RETRIES ? parseInt(process.env.ELASTIC_MAX_RETRIES, 10) : 3,
+            requestTimeout: process.env.ELASTIC_REQUEST_TIMEOUT ? parseInt(process.env.ELASTIC_REQUEST_TIMEOUT, 10) : 30000,
+            pingTimeout: process.env.ELASTIC_PING_TIMEOUT ? parseInt(process.env.ELASTIC_PING_TIMEOUT, 10) : 3000,
+        }),
+        logging: {
+            level: process.env.LOG_LEVEL || 'info',
+            format: process.env.LOG_FORMAT || 'text',
+        },
+        server: {
+            maxConcurrentRequests: process.env.MAX_CONCURRENT_REQUESTS ? parseInt(process.env.MAX_CONCURRENT_REQUESTS, 10) : 10,
+            requestTimeoutMs: process.env.REQUEST_TIMEOUT_MS ? parseInt(process.env.REQUEST_TIMEOUT_MS, 10) : 30000,
+        },
+    };
+    validateConfig(config);
+    return config;
+}
+function validateConfig(config) {
+    const { elasticsearch } = config;
+    if (!elasticsearch.cloudId && !elasticsearch.node) {
+        throw new Error('Either ELASTIC_CLOUD_ID or ELASTIC_NODE must be provided');
+    }
+    if (elasticsearch.cloudId && !elasticsearch.apiKey) {
+        throw new Error('ELASTIC_API_KEY is required when using Elastic Cloud');
+    }
+    if (elasticsearch.node && !elasticsearch.auth && !elasticsearch.apiKey) {
+        throw new Error('Authentication (username/password or API key) is required');
+    }
+}
+//# sourceMappingURL=config.js.map

package/build/config.js.map

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

package/build/elasticsearch/client.d.ts

@@ -0,0 +1,26 @@
+import { Client } from '@elastic/elasticsearch';
+import { ElasticConfig } from '../config.js';
+import { Logger } from '../logger.js';
+export interface ConnectionInfo {
+    isConnected: boolean;
+    clusterName?: string;
+    version?: string;
+    lastHealthCheck: Date;
+    error?: string;
+}
+export declare class ElasticsearchManager {
+    private client;
+    private config;
+    private logger;
+    private connectionInfo;
+    private healthCheckInterval;
+    constructor(config: ElasticConfig, logger: Logger);
+    initialize(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+    reconnect(): Promise<void>;
+    getClient(): Client;
+    getConnectionInfo(): ConnectionInfo;
+    private startHealthMonitoring;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/build/elasticsearch/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/elasticsearch/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,mBAAmB,CAA+B;gBAE9C,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM;IAS3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2D3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiB/B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAUhC,SAAS,IAAI,MAAM;IAUnB,iBAAiB,IAAI,cAAc;IAInC,OAAO,CAAC,qBAAqB;IAOvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAmBhC"}

package/build/elasticsearch/client.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElasticsearchManager = void 0;
+const elasticsearch_1 = require("@elastic/elasticsearch");
+class ElasticsearchManager {
+    client = null;
+    config;
+    logger;
+    connectionInfo;
+    healthCheckInterval = null;
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger.child({ component: 'elasticsearch' });
+        this.connectionInfo = {
+            isConnected: false,
+            lastHealthCheck: new Date(),
+        };
+    }
+    async initialize() {
+        try {
+            this.logger.info('Initializing Elasticsearch client', {
+                cloudId: this.config.cloudId ? '***' : undefined,
+                node: this.config.node,
+                hasApiKey: !!this.config.apiKey,
+                hasAuth: !!this.config.auth,
+            });
+            const clientOptions = {
+                maxRetries: this.config.maxRetries,
+                requestTimeout: this.config.requestTimeout,
+                pingTimeout: this.config.pingTimeout,
+                sniffOnStart: this.config.sniffOnStart,
+                ...(this.config.sniffInterval && { sniffInterval: this.config.sniffInterval }),
+            };
+            if (this.config.cloudId) {
+                clientOptions.cloud = { id: this.config.cloudId };
+                if (this.config.apiKey) {
+                    clientOptions.auth = { apiKey: this.config.apiKey };
+                }
+            }
+            else if (this.config.node) {
+                clientOptions.node = this.config.node;
+                if (this.config.apiKey) {
+                    clientOptions.auth = { apiKey: this.config.apiKey };
+                }
+                else if (this.config.auth) {
+                    clientOptions.auth = {
+                        username: this.config.auth.username,
+                        password: this.config.auth.password,
+                    };
+                }
+            }
+            if (this.config.ssl) {
+                clientOptions.tls = {
+                    rejectUnauthorized: this.config.ssl.rejectUnauthorized,
+                };
+            }
+            this.client = new elasticsearch_1.Client(clientOptions);
+            // Mark as connected immediately - actual API calls will handle connection errors
+            // Health checks with limited permissions often fail, so we skip them
+            this.connectionInfo = {
+                isConnected: true,
+                lastHealthCheck: new Date(),
+            };
+            // Start health monitoring (non-blocking, won't cause failures)
+            this.startHealthMonitoring();
+            this.logger.info('Elasticsearch client initialized successfully');
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize Elasticsearch client', {}, error);
+            throw error;
+        }
+    }
+    async healthCheck() {
+        if (!this.client) {
+            this.connectionInfo = {
+                isConnected: false,
+                lastHealthCheck: new Date(),
+                error: 'Client not initialized',
+            };
+            return false;
+        }
+        // For users with limited permissions, we skip health checks
+        // The client is marked as connected, and actual API calls will handle errors gracefully
+        // Health checks requiring cluster privileges often fail unnecessarily
+        this.connectionInfo.lastHealthCheck = new Date();
+        return this.connectionInfo.isConnected;
+    }
+    async reconnect() {
+        this.logger.info('Attempting to reconnect to Elasticsearch');
+        if (this.client) {
+            await this.client.close();
+        }
+        await this.initialize();
+    }
+    getClient() {
+        if (!this.client) {
+            throw new Error('Elasticsearch client not initialized');
+        }
+        // Don't check isConnected - let the actual API calls handle connection errors
+        // This allows tools to work even if health checks fail due to permissions
+        return this.client;
+    }
+    getConnectionInfo() {
+        return { ...this.connectionInfo };
+    }
+    startHealthMonitoring() {
+        // Disabled health monitoring for users with limited permissions
+        // Periodic health checks often fail unnecessarily and cause reconnections
+        // Actual API calls will handle connection errors gracefully
+        this.logger.debug('Health monitoring disabled (limited permissions mode)');
+    }
+    async shutdown() {
+        this.logger.info('Shutting down Elasticsearch manager');
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+        if (this.client) {
+            try {
+                await this.client.close();
+                this.logger.info('Elasticsearch client closed');
+            }
+            catch (error) {
+                this.logger.warn('Error closing Elasticsearch client', { error: error.message });
+            }
+        }
+        this.connectionInfo.isConnected = false;
+    }
+}
+exports.ElasticsearchManager = ElasticsearchManager;
+//# sourceMappingURL=client.js.map

package/build/elasticsearch/client.js.map

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