es6-mcp-server 1.0.0

package/bin/es6-mcp-server

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../index.js"

package/bin/es6-mcp-server.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../index.js')

package/index.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+/*
+ * @op/es6-mcp-server
+ *
+ * ES 6.x-compatible MCP server for Operative Elasticsearch clusters.
+ *
+ * Root cause: @elastic/elasticsearch v9 hardcodes `productCheck: 'Elasticsearch'`
+ * in the Client constructor, triggering the @elastic/transport ProductCheck
+ * middleware. ES 6.x clusters never send the required `X-Elastic-Product:
+ * Elasticsearch` response header (introduced in ES 7.14), so every 2xx
+ * response throws ProductNotSupportedError.
+ *
+ * Fix: subclass Transport to override productCheck: null before the middleware
+ * registers it, and override vendoredHeaders to plain application/json
+ * (ES 6.x rejects `application/vnd.elasticsearch+json; compatible-with=9`
+ * with HTTP 406).
+ *
+ * Tools exposed: list_indices, get_mappings, search, get_shards
+ * (same interface as @elastic/mcp-server-elasticsearch v0.3.1)
+ *
+ * Environment variables:
+ *   ES_URL              — Elasticsearch endpoint (required)
+ *   ES_API_KEY          — API key auth (optional)
+ *   ES_USERNAME         — Basic auth username (optional)
+ *   ES_PASSWORD         — Basic auth password (optional)
+ *   ES_PATH_PREFIX      — URL path prefix (optional)
+ *   ES_SSL_SKIP_VERIFY  — Skip TLS verification, '1' or 'true' (optional)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { Client, Transport } from '@elastic/elasticsearch'
+import { z } from 'zod'
+
+class CompatTransport extends Transport {
+  constructor (opts) {
+    super({
+      ...opts,
+      productCheck: null,
+      vendoredHeaders: {
+        jsonContentType: 'application/json',
+        ndjsonContentType: 'application/x-ndjson',
+        accept: 'application/json,text/plain'
+      }
+    })
+  }
+}
+
+const url = process.env.ES_URL ?? ''
+const apiKey = process.env.ES_API_KEY
+const username = process.env.ES_USERNAME
+const password = process.env.ES_PASSWORD
+const sslSkipVerify = process.env.ES_SSL_SKIP_VERIFY === '1' || process.env.ES_SSL_SKIP_VERIFY === 'true'
+const pathPrefix = process.env.ES_PATH_PREFIX
+
+const clientOpts = {
+  node: url,
+  Transport: CompatTransport,
+  tls: sslSkipVerify ? { rejectUnauthorized: false } : {}
+}
+
+if (apiKey) {
+  clientOpts.auth = { apiKey }
+} else if (username && password) {
+  clientOpts.auth = { username, password }
+}
+
+if (pathPrefix) {
+  const prefix = pathPrefix
+  clientOpts.Transport = class extends CompatTransport {
+    async request (params, options) {
+      return super.request({ ...params, path: prefix + params.path }, options)
+    }
+  }
+}
+
+const esClient = new Client(clientOpts)
+const server = new McpServer({ name: 'elasticsearch-mcp-compat', version: '1.0.0' })
+
+server.tool(
+  'list_indices',
+  'List all available Elasticsearch indices',
+  { indexPattern: z.string().trim().min(1).describe('Index pattern of Elasticsearch indices to list') },
+  async ({ indexPattern }) => {
+    try {
+      const response = await esClient.cat.indices({ index: indexPattern, format: 'json' })
+      const info = response.map(i => ({
+        index: i.index,
+        health: i.health,
+        status: i.status,
+        docsCount: i.docsCount ?? i['docs.count']
+      }))
+      return {
+        content: [
+          { type: 'text', text: `Found ${info.length} indices` },
+          { type: 'text', text: JSON.stringify(info, null, 2) }
+        ]
+      }
+    } catch (err) {
+      return { content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }] }
+    }
+  }
+)
+
+server.tool(
+  'get_mappings',
+  'Get field mappings for a specific Elasticsearch index',
+  { index: z.string().trim().min(1).describe('Name of the Elasticsearch index to get mappings for') },
+  async ({ index }) => {
+    try {
+      const r = await esClient.indices.getMapping({ index })
+      return {
+        content: [
+          { type: 'text', text: `Mappings for index: ${index}` },
+          { type: 'text', text: `Mappings for index ${index}: ${JSON.stringify(r[index]?.mappings ?? {}, null, 2)}` }
+        ]
+      }
+    } catch (err) {
+      return { content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }] }
+    }
+  }
+)
+
+server.tool(
+  'search',
+  'Perform an Elasticsearch search with the provided query DSL. Highlights are always enabled.',
+  {
+    index: z.string().trim().min(1).describe('Name of the Elasticsearch index to search'),
+    queryBody: z.record(z.any()).describe('Complete Elasticsearch query DSL object that can include query, size, from, sort, etc.'),
+    profile: z.boolean().optional().default(false).describe('Whether to include query profiling information'),
+    explain: z.boolean().optional().default(false).describe('Whether to include explanation of how the query was executed')
+  },
+  async ({ index, queryBody, profile, explain }) => {
+    try {
+      const mappingResponse = await esClient.indices.getMapping({ index })
+      const indexMappings = mappingResponse[index]?.mappings ?? {}
+      const searchRequest = { index, ...queryBody, profile, explain }
+
+      if (indexMappings.properties != null) {
+        const textFields = {}
+        for (const [fieldName, fieldData] of Object.entries(indexMappings.properties)) {
+          if (fieldData.type === 'text' || 'dense_vector' in fieldData) {
+            textFields[fieldName] = {}
+          }
+        }
+        searchRequest.highlight = { fields: textFields, pre_tags: ['<em>'], post_tags: ['</em>'] }
+      }
+
+      const result = await esClient.search(searchRequest)
+      const from = queryBody.from ?? 0
+      const total = typeof result.hits.total === 'number' ? result.hits.total : (result.hits.total?.value ?? 0)
+      const metaFragment = { type: 'text', text: `Total results: ${total}, showing ${result.hits.hits.length} from position ${from}` }
+
+      const contentFragments = result.hits.hits.map(hit => {
+        const highlighted = hit.highlight ?? {}
+        const source = hit._source ?? {}
+        let content = ''
+        for (const [field, fragments] of Object.entries(highlighted)) {
+          if (fragments?.length > 0) content += `${field} (highlighted): ${fragments.join(' ... ')}\n`
+        }
+        for (const [field, value] of Object.entries(source)) {
+          if (!(field in highlighted)) content += `${field}: ${JSON.stringify(value)}\n`
+        }
+        if (explain && hit._explanation) content += `\nExplanation:\n${JSON.stringify(hit._explanation, null, 2)}`
+        return { type: 'text', text: content.trim() }
+      })
+
+      const aggregationsFragment = result.aggregations != null
+        ? { type: 'text', text: `Aggregations: ${JSON.stringify(result.aggregations, null, 2)}` }
+        : null
+
+      const profileFragment = (profile && result.profile)
+        ? { type: 'text', text: `\nQuery Profile:\n${JSON.stringify(result.profile, null, 2)}` }
+        : null
+
+      const fragments = [metaFragment]
+      if (aggregationsFragment) fragments.push(aggregationsFragment)
+      fragments.push(...contentFragments)
+      if (profileFragment) fragments.push(profileFragment)
+
+      return { content: fragments }
+    } catch (err) {
+      return { content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }] }
+    }
+  }
+)
+
+server.tool(
+  'get_shards',
+  'Get shard information for all or specific indices',
+  { index: z.string().optional().describe('Optional index name to get shard information for') },
+  async ({ index }) => {
+    try {
+      const response = await esClient.cat.shards({ index, format: 'json' })
+      const shards = response.map(s => ({
+        index: s.index, shard: s.shard, prirep: s.prirep,
+        state: s.state, docs: s.docs, store: s.store, ip: s.ip, node: s.node
+      }))
+      return {
+        content: [
+          { type: 'text', text: `Found ${shards.length} shards${index != null ? ` for index ${index}` : ''}` },
+          { type: 'text', text: JSON.stringify(shards, null, 2) }
+        ]
+      }
+    } catch (err) {
+      return { content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }] }
+    }
+  }
+)
+
+const transport = new StdioServerTransport()
+await server.connect(transport)
+process.on('SIGINT', () => { server.close().finally(() => process.exit(0)) })

package/index.mjs

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+/*
+ * @op/es6-mcp-server
+ *
+ * ES 6.x-compatible MCP server for Operative Elasticsearch clusters.
+ *
+ * Root cause: @elastic/elasticsearch v9 hardcodes `productCheck: 'Elasticsearch'`
+ * in the Client constructor, triggering the @elastic/transport ProductCheck
+ * middleware. ES 6.x clusters never send the required `X-Elastic-Product:
+ * Elasticsearch` response header (introduced in ES 7.14), so every 2xx
+ * response throws ProductNotSupportedError.
+ *
+ * Fix: subclass Transport to override productCheck: null before the middleware
+ * registers it, and override vendoredHeaders to plain application/json
+ * (ES 6.x rejects `application/vnd.elasticsearch+json; compatible-with=9`
+ * with HTTP 406).
+ *
+ * Tools exposed: list_indices, get_mappings, search, get_shards
+ * (same interface as @elastic/mcp-server-elasticsearch v0.3.1)
+ *
+ * Environment variables:
+ *   ES_URL              — Elasticsearch endpoint (required)
+ *   ES_API_KEY          — API key auth (optional)
+ *   ES_USERNAME         — Basic auth username (optional)
+ *   ES_PASSWORD         — Basic auth password (optional)
+ *   ES_PATH_PREFIX      — URL path prefix (optional)
+ *   ES_SSL_SKIP_VERIFY  — Skip TLS verification, '1' or 'true' (optional)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { Client, Transport } from '@elastic/elasticsearch'
+import { z } from 'zod'
+
+class CompatTransport extends Transport {
+  constructor (opts) {
+    super({
+      ...opts,
+      productCheck: null,
+      vendoredHeaders: {
+        jsonContentType: 'application/json',
+        ndjsonContentType: 'application/x-ndjson',
+        accept: 'application/json,text/plain'
+      }
+    })
+  }
+}
+
+const url = process.env.ES_URL ?? ''
+const apiKey = process.env.ES_API_KEY
+const username = process.env.ES_USERNAME
+const password = process.env.ES_PASSWORD
+const sslSkipVerify = process.env.ES_SSL_SKIP_VERIFY === '1' || process.env.ES_SSL_SKIP_VERIFY === 'true'
+const pathPrefix = process.env.ES_PATH_PREFIX
+
+const clientOpts = {
+  node: url,
+  Transport: CompatTransport,
+  tls: sslSkipVerify ? { rejectUnauthorized: false } : {}
+}
+
+if (apiKey) {
+  clientOpts.auth = { apiKey }
+} else if (username && password) {
+  clientOpts.auth = { username, password }
+}
+
+if (pathPrefix) {
+  const prefix = pathPrefix
+  clientOpts.Transport = class extends CompatTransport {
+    async request (params, options) {
+      return super.request({ ...params, path: prefix + params.path }, options)
+    }
+  }
+}
+
+const esClient = new Client(clientOpts)
+const server = new McpServer({ name: 'elasticsearch-mcp-compat', version: '1.0.0' })
+
+server.tool(
+  'list_indices',
+  'List all available Elasticsearch indices',
+  { indexPattern: z.string().trim().min(1).describe('Index pattern of Elasticsearch indices to list') },
+  async ({ indexPattern }) => {
+    try {
+      const response = await esClient.cat.indices({ index: indexPattern, format: 'json' })
+      const info = response.map(i => ({
+        index: i.index,
+        health: i.health,
+        status: i.status,
+        docsCount: i.docsCount ?? i['docs.count']
+      }))
+      return {
+        content: [
+          { type: 'text', text: `Found ${info.length} indices` },
+          { type: 'text', text: JSON.stringify(info, null, 2) }
+        ]
+      }
+    } catch (err) {
+      return { content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }] }
+    }
+  }
+)
+
+server.tool(
+  'get_mappings',
+  'Get field mappings for a specific Elasticsearch index',
+  { index: z.string().trim().min(1).describe('Name of the Elasticsearch index to get mappings for') },
+  async ({ index }) => {
+    try {
+      const r = await esClient.indices.getMapping({ index })
+      return {
+        content: [
+          { type: 'text', text: `Mappings for index: ${index}` },
+          { type: 'text', text: `Mappings for index ${index}: ${JSON.stringify(r[index]?.mappings ?? {}, null, 2)}` }
+        ]
+      }
+    } catch (err) {
+      return { content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }] }
+    }
+  }
+)
+
+server.tool(
+  'search',
+  'Perform an Elasticsearch search with the provided query DSL. Highlights are always enabled.',
+  {
+    index: z.string().trim().min(1).describe('Name of the Elasticsearch index to search'),
+    queryBody: z.record(z.any()).describe('Complete Elasticsearch query DSL object that can include query, size, from, sort, etc.'),
+    profile: z.boolean().optional().default(false).describe('Whether to include query profiling information'),
+    explain: z.boolean().optional().default(false).describe('Whether to include explanation of how the query was executed')
+  },
+  async ({ index, queryBody, profile, explain }) => {
+    try {
+      const mappingResponse = await esClient.indices.getMapping({ index })
+      const indexMappings = mappingResponse[index]?.mappings ?? {}
+      const searchRequest = { index, ...queryBody, profile, explain }
+
+      if (indexMappings.properties != null) {
+        const textFields = {}
+        for (const [fieldName, fieldData] of Object.entries(indexMappings.properties)) {
+          if (fieldData.type === 'text' || 'dense_vector' in fieldData) {
+            textFields[fieldName] = {}
+          }
+        }
+        searchRequest.highlight = { fields: textFields, pre_tags: ['<em>'], post_tags: ['</em>'] }
+      }
+
+      const result = await esClient.search(searchRequest)
+      const from = queryBody.from ?? 0
+      const total = typeof result.hits.total === 'number' ? result.hits.total : (result.hits.total?.value ?? 0)
+      const metaFragment = { type: 'text', text: `Total results: ${total}, showing ${result.hits.hits.length} from position ${from}` }
+
+      const contentFragments = result.hits.hits.map(hit => {
+        const highlighted = hit.highlight ?? {}
+        const source = hit._source ?? {}
+        let content = ''
+        for (const [field, fragments] of Object.entries(highlighted)) {
+          if (fragments?.length > 0) content += `${field} (highlighted): ${fragments.join(' ... ')}\n`
+        }
+        for (const [field, value] of Object.entries(source)) {
+          if (!(field in highlighted)) content += `${field}: ${JSON.stringify(value)}\n`
+        }
+        if (explain && hit._explanation) content += `\nExplanation:\n${JSON.stringify(hit._explanation, null, 2)}`
+        return { type: 'text', text: content.trim() }
+      })
+
+      const aggregationsFragment = result.aggregations != null
+        ? { type: 'text', text: `Aggregations: ${JSON.stringify(result.aggregations, null, 2)}` }
+        : null
+
+      const profileFragment = (profile && result.profile)
+        ? { type: 'text', text: `\nQuery Profile:\n${JSON.stringify(result.profile, null, 2)}` }
+        : null
+
+      const fragments = [metaFragment]
+      if (aggregationsFragment) fragments.push(aggregationsFragment)
+      fragments.push(...contentFragments)
+      if (profileFragment) fragments.push(profileFragment)
+
+      return { content: fragments }
+    } catch (err) {
+      return { content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }] }
+    }
+  }
+)
+
+server.tool(
+  'get_shards',
+  'Get shard information for all or specific indices',
+  { index: z.string().optional().describe('Optional index name to get shard information for') },
+  async ({ index }) => {
+    try {
+      const response = await esClient.cat.shards({ index, format: 'json' })
+      const shards = response.map(s => ({
+        index: s.index, shard: s.shard, prirep: s.prirep,
+        state: s.state, docs: s.docs, store: s.store, ip: s.ip, node: s.node
+      }))
+      return {
+        content: [
+          { type: 'text', text: `Found ${shards.length} shards${index != null ? ` for index ${index}` : ''}` },
+          { type: 'text', text: JSON.stringify(shards, null, 2) }
+        ]
+      }
+    } catch (err) {
+      return { content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }] }
+    }
+  }
+)
+
+const transport = new StdioServerTransport()
+await server.connect(transport)
+process.on('SIGINT', () => { server.close().finally(() => process.exit(0)) })

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "es6-mcp-server",
+  "version": "1.0.0",
+  "description": "ES 6.x-compatible MCP server. Bypasses the @elastic/elasticsearch v9 product-check that fails on Elasticsearch 6.x clusters.",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "es6-mcp-server": "bin/es6-mcp-server.js"
+  },
+  "dependencies": {
+    "@elastic/elasticsearch": "^9.4.2",
+    "@modelcontextprotocol/sdk": "^1.13.2",
+    "zod": "^3.25.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "elasticsearch",
+    "mcp",
+    "mcp-server",
+    "operative"
+  ],
+  "license": "UNLICENSED",
+  "private": false
+}