@havesomecode/kibana-mcp-server 1.4.0 → 1.4.1

package/README.md

@@ -50,6 +50,8 @@ npx skills add Havesomecode/kibana-mcp-server \
 
 `INSTALL.md` is the deterministic install and handoff guide for agents.
 
+For a version-matched handoff, resolve the selected branch, tag, or package metadata to the full commit SHA. That SHA is the **resolved installation commit** used in `https://raw.githubusercontent.com/Havesomecode/kibana-mcp-server/<resolved-commit>/README.md`. Read `INSTALL.md` and the skills from the same commit. Do not infer a Git tag from an npm version; use the exact package's `gitHead`. A maintained checkout can verify the handoff with `node scripts/readme-handoff.mjs <resolved-installation-ref>`.
+
 ## Run it as a shared service
 
 By default the server speaks stdio and serves one configuration. Over HTTP, one process serves every caller of your gateway, each with their own source catalog:
@@ -75,11 +77,16 @@ kibana-mcp-server serve --http --config ./kibana.mcp.config.ts
 
 Catalogs can live in files, Redis, PostgreSQL, MongoDB, SQLite, or a store you write. The HTTP transport trusts the profile header as sent: only a gateway that has authenticated the caller should reach it.
 
+## Repository Codex plugin
+
+`npm run build` creates a self-contained runtime in `plugins/kibana-log-investigation/dist/`. The repo-local Codex plugin launches that installed bundle through `mcp-launcher.mjs`, without depending on the original checkout or its `node_modules`. Use `npm run verify:entrypoint` for the isolated copied-plugin handshake, and inspect Codex's MCP startup status plus sanitized stderr before restarting a discussion.
+
 ## Documentation
 
 | Topic | Link |
 | --- | --- |
 | Getting started | https://havesomecode.github.io/kibana-mcp-server/guide/getting-started |
+| Agent plugins and skills | https://havesomecode.github.io/kibana-mcp-server/ai/agent-plugins |
 | Investigating with an agent | https://havesomecode.github.io/kibana-mcp-server/guide/investigating |
 | HTTP transport and security model | https://havesomecode.github.io/kibana-mcp-server/deployment/http |
 | Catalog stores | https://havesomecode.github.io/kibana-mcp-server/deployment/catalog-stores |

package/dist/src/mcp_entry.js

@@ -1,6 +1,3 @@
 #!/usr/bin/env node
 import { startMcpServer } from "./transports/stdio.js";
-startMcpServer().catch((error) => {
-    console.error(error);
-    process.exitCode = 1;
-});
+await startMcpServer();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@havesomecode/kibana-mcp-server",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "license": "MIT",
   "description": "Read-only MCP server for Kibana-backed log investigation and schema-aware querying",
   "homepage": "https://havesomecode.github.io/kibana-mcp-server/",
@@ -49,6 +49,9 @@
     "dist/**",
     "plugins/kibana-log-investigation/.mcp.json",
     "plugins/kibana-log-investigation/.codex-plugin/plugin.json",
+    "plugins/kibana-log-investigation/mcp-launcher.mjs",
+    "plugins/kibana-log-investigation/dist/**",
+    "plugins/kibana-log-investigation/skills/**",
     "skills/kibana-log-investigation/**",
     "README.md",
     "LICENSE",
@@ -59,7 +62,7 @@
     "node": ">=22.0.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && node scripts/build-plugin.mjs",
     "check:types": "tsc --noEmit -p tsconfig.json",
     "lint": "biome lint .",
     "format": "biome format . --write",
@@ -111,6 +114,7 @@
     "@commitlint/cli": "^20.1.0",
     "@commitlint/config-conventional": "^20.0.0",
     "@types/node": "^25.5.2",
+    "esbuild": "^0.28.2",
     "ioredis": "^6.0.0",
     "mongodb": "^7.6.0",
     "pg": "^8.23.0",

package/plugins/kibana-log-investigation/.mcp.json

@@ -3,8 +3,9 @@
     "kibana-log-investigation": {
       "type": "stdio",
       "command": "node",
-      "args": ["./dist/src/mcp_entry.js"],
-      "note": "Local stdio MCP server for this repo. Requires Node.js 22+ and a built dist/ directory. If dependencies or dist are missing, run npm install and npm run build from the repository root first."
+      "args": ["./mcp-launcher.mjs"],
+      "cwd": ".",
+      "note": "Requires Node.js 22+. The built plugin includes its runtime dependencies. Build the checkout before installing the plugin. If runtime files are missing, rebuild and reinstall; opening new discussions does not repair startup failures."
     }
   }
 }

package/plugins/kibana-log-investigation/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zacaria
+
+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.