@havesomecode/kibana-mcp-server 0.1.0

package/docs/project/support-policy.md

@@ -0,0 +1,52 @@
+---
+title: Support Policy
+status: active
+updated: 2026-04-09
+---
+
+# Support Policy
+
+## Audience
+
+This MCP is designed for operators and AI agents that need read-only access to Kibana-backed logs for investigation workflows.
+
+## Guaranteed Support
+
+- Node.js 22+ runtime
+- Repo-local Codex plugin install
+- `kibana_internal_search_es` and `elasticsearch_search` backends
+- Guided machine setup with saved profiles and imported source catalogs
+- Runtime configuration via `configure` plus persisted non-secret source catalogs
+
+## Best-Effort Support
+
+- Fully autonomous repo-local plugin installation by prompting alone across all Codex model variants
+- Schema metadata endpoints (`kibana_data_views_fields`, `kibana_index_patterns_fields`, `elasticsearch_field_caps`)
+- Nested query features that depend on schema availability
+- Public package installs (once enabled)
+
+Best-effort means we will investigate issues but cannot guarantee behavior across all deployments.
+
+## Known Environment Constraints
+
+- Some Codex model variants are less reliable at completing repo-local plugin installation without a manual Codex UI step. The supported fallback is to install the plugin manually from the local marketplace, then continue with MCP configuration.
+- Some Kibana deployments proxy or block schema metadata endpoints. In those cases, schema-aware features may be unavailable.
+- `KIBANA_BASE_URL` must be the Kibana base prefix, not a full search endpoint such as `/internal/search/es`.
+- Linux secure storage depends on a Secret Service-compatible keyring being available and unlocked.
+- If you run staging and production side by side, prefer saved machine profiles plus `KIBANA_PROFILE` selection. If you stay on env bootstrap, keep `KIBANA_SOURCE_CATALOG_PATH` distinct per entry so runtime-persisted sources do not overwrite each other.
+- Credentials are not persisted to repo-local files or tracked config. Guided setup stores them in the platform credential store.
+
+## Security Reporting
+
+If you find a security issue, report it through the process documented in `SECURITY.md`.
+
+## Response Expectations
+
+- Critical security reports: acknowledge within 3 business days.
+- Non-security issues: response cadence depends on maintainer availability.
+- Release notes and shipped version history are published through GitHub Releases and npm, not through committed changelog updates in the repository.
+
+## Out of Scope
+
+- Writes to Kibana, Elasticsearch, or data views
+- Workflow-specific automation beyond log investigation

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@havesomecode/kibana-mcp-server",
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "Read-only MCP server for Kibana-backed log investigation and schema-aware querying",
+  "homepage": "https://github.com/Zacaria/kibana-mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Zacaria/kibana-mcp-server.git"
+  },
+  "type": "module",
+  "main": "dist/src/mcp_entry.js",
+  "bin": {
+    "kibana-mcp-server": "dist/src/index.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "files": [
+    "dist/**",
+    "plugins/kibana-log-investigation/.mcp.json",
+    "plugins/kibana-log-investigation/.codex-plugin/plugin.json",
+    "README.md",
+    "LICENSE",
+    "config/sources.example.json",
+    "docs/project/**"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check:types": "tsc --noEmit -p tsconfig.json",
+    "lint": "biome lint .",
+    "format": "biome format . --write",
+    "format:check": "biome check . --linter-enabled=false",
+    "check": "npm run check:types && npm run lint && npm run format:check",
+    "dev": "tsx src/mcp_entry.ts",
+    "release": "semantic-release",
+    "release:dry-run": "semantic-release --dry-run",
+    "setup": "node dist/src/index.js setup",
+    "start": "node dist/src/mcp_entry.js",
+    "test": "vitest run",
+    "verify:release-contract": "node scripts/verify-release-contract.mjs",
+    "verify:packlist": "node scripts/verify-packlist.mjs",
+    "verify:entrypoint": "node scripts/verify-mcp-entrypoint.mjs",
+    "verify": "npm run check && npm run test && npm run build && npm run verify:entrypoint && npm run verify:release-contract && npm run verify:packlist"
+  },
+  "dependencies": {
+    "@cfworker/json-schema": "^4.1.1",
+    "@modelcontextprotocol/server": "^2.0.0-alpha.2",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.8.3",
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
+    "@types/node": "^24.0.0",
+    "semantic-release": "^25.0.1",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}

package/plugins/kibana-log-investigation/.codex-plugin/plugin.json

@@ -0,0 +1,31 @@
+{
+  "name": "kibana-log-investigation",
+  "version": "0.1.0",
+  "description": "Install the local Kibana log investigation MCP from this repository.",
+  "author": {
+    "name": "Zacaria",
+    "url": "https://github.com/Zacaria"
+  },
+  "homepage": "https://github.com/Zacaria/kibana-mcp-server",
+  "repository": "https://github.com/Zacaria/kibana-mcp-server",
+  "license": "MIT",
+  "keywords": ["kibana", "logs", "mcp", "investigation", "codex"],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Kibana Log Investigation",
+    "shortDescription": "Local Kibana log investigation MCP for Codex",
+    "longDescription": "Install a local stdio MCP server from this repository so Codex can discover sources, inspect schema metadata, and query Kibana-backed logs without additional hosting. This repo is the primary distribution contract today; public distribution is planned once artifact verification is stable.",
+    "developerName": "Zacaria",
+    "category": "Productivity",
+    "capabilities": ["Interactive", "Read", "Write"],
+    "websiteURL": "https://github.com/Zacaria/kibana-mcp-server",
+    "privacyPolicyURL": "https://github.com/Zacaria/kibana-mcp-server",
+    "termsOfServiceURL": "https://github.com/Zacaria/kibana-mcp-server",
+    "defaultPrompt": [
+      "Install the Kibana Log Investigation plugin from this repo, bootstrap Node.js if needed, and configure it for my Kibana environment.",
+      "Use the Kibana Log Investigation plugin to inspect log sources and query a time window."
+    ],
+    "brandColor": "#1F6FEB"
+  }
+}

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

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "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."
+    }
+  }
+}