{"_id":"@eden-kl/kibana-claude","name":"@eden-kl/kibana-claude","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@eden-kl/kibana-claude","version":"0.1.0","description":"CLI tool to set up Claude Code Skills and MCP server for querying Kibana logs","type":"module","bin":{"kibana-claude":"dist/cli/index.js"},"main":"./dist/lib/index.js","exports":{".":"./dist/lib/index.js","./mcp":"./dist/mcp/server.js","./formatter":"./dist/mcp/formatter.js"},"scripts":{"build":"tsc","dev":"tsx src/mcp/server.ts","start:mcp":"node dist/mcp/server.js"},"keywords":["kibana","elasticsearch","claude","claude-code","mcp","skills","log-analysis"],"author":{"name":"Eden Chen"},"license":"MIT","publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","dotenv":"^17.3.1","ink":"^6.8.0","ink-select-input":"^6.2.0","ink-text-input":"^6.0.0","react":"^19.2.4","zod":"^4.3.6"},"engines":{"node":">=18.0.0"},"devDependencies":{"@types/node":"^25.3.5","@types/react":"^19.2.14","tsx":"^4.21.0","typescript":"^5.9.3"},"_id":"@eden-kl/kibana-claude@0.1.0","gitHead":"a167158e817ac721f2243bc81b91515b530300e2","_nodeVersion":"22.17.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-DiYHMoHRzlQRCP4pvYfACa+tMy8rtFEfdZZ5bcrNkuxOeWz1ZwnaMOHnLpeB+OmqneU1Pzr7x8AWvoO7qaUIlw==","shasum":"9b60baeed39d4b75b0cba67a053185d903aabe0e","tarball":"https://registry.npmjs.org/@eden-kl/kibana-claude/-/kibana-claude-0.1.0.tgz","fileCount":34,"unpackedSize":121342,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDDVNEcPKDv2cGqlaUrBBqAvxyyA+2fVEAgRi0GnCJzhAIgYJWrh76uTlN4ymEGXLYEoKqIYj7B5D6BP8t7F0viqJE="}]},"_npmUser":{"name":"eden-kl","email":"wl02635565@gmail.com"},"directories":{},"maintainers":[{"name":"eden-kl","email":"wl02635565@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/kibana-claude_0.1.0_1772961323145_0.8120748971889862"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-08T09:15:23.077Z","0.1.0":"2026-03-08T09:15:23.282Z","modified":"2026-03-08T09:15:23.452Z"},"maintainers":[{"name":"eden-kl","email":"wl02635565@gmail.com"}],"description":"CLI tool to set up Claude Code Skills and MCP server for querying Kibana logs","keywords":["kibana","elasticsearch","claude","claude-code","mcp","skills","log-analysis"],"author":{"name":"Eden Chen"},"license":"MIT","readme":"# kibana-claude\n\n用來在 Claude Code 中直接查詢 Kibana log 的 CLI 工具，提供 **Claude Code Skills** 和 **MCP server** 兩種整合方式。\n\n不需要直接存取 Elasticsearch — 透過 Kibana 內部 API 進行查詢。\n\n**[English README](./README.md)**\n\n## 功能特色\n\n- **不依賴 ES 直連**：使用 Kibana 內部 HTTP API，無需 Elasticsearch 權限\n- **Session 自動管理**：自動處理 anonymous 登入，401 時自動刷新 session\n- **通用 + 專用工具分離**：內建工具適用所有 Kibana；各團隊可自行新增專用工具\n- **Claude Code Skills**：預建的 log 搜尋、錯誤分析、摘要 Skill 模板\n- **MCP Server**：讓 Claude Code 能實際執行 Kibana 查詢的工具介面\n- **TypeScript**：完整型別定義\n\n## 快速開始\n\n```bash\n# 1. 全域安裝\nnpm install -g kibana-claude\n\n# 2. 互動式初始化設定\nkibana-claude init\n\n# 3. 測試連線\nkibana-claude test\n\n# 4. 安裝 Skills 到你的專案\ncd your-project\nkibana-claude install-skills\n\n# 5. 或設定 MCP server\nkibana-claude install-mcp\n```\n\n## 指令說明\n\n| 指令 | 說明 |\n|------|------|\n| `kibana-claude init` | 互動式設定精靈（Kibana URL、認證方式、預設值） |\n| `kibana-claude test` | 測試 Kibana 連線是否正常 |\n| `kibana-claude install-skills` | 安裝 Claude Code Skills 到 `.claude/skills/` |\n| `kibana-claude install-mcp` | 設定 MCP server 到 `.claude/mcp.json` |\n| `kibana-claude auth` | 手動刷新 session |\n| `kibana-claude auth --show` | 查看目前 session 資訊 |\n\n## 運作原理\n\n```\n┌─────────────────────────────────────────────────────┐\n│ Claude Code                                         │\n│                                                     │\n│  Skills (markdown)         MCP Server (stdio)       │\n│  ┌──────────────┐         ┌──────────────────┐      │\n│  │ search-logs  │         │ search_by_keyword │      │\n│  │ error-analysis│        │ get_log_detail    │      │\n│  │ log-summary  │         │ refresh_cookie    │      │\n│  └──────────────┘         └────────┬─────────┘      │\n│                                    │                 │\n└────────────────────────────────────┼─────────────────┘\n                                     │\n                              ┌──────▼──────┐\n                              │  Core Lib   │\n                              │  auth.ts    │\n                              │  search.ts  │\n                              │  config.ts  │\n                              └──────┬──────┘\n                                     │\n                              ┌──────▼──────┐\n                              │   Kibana    │\n                              │ /internal/  │\n                              │  bsearch    │\n                              └─────────────┘\n```\n\n## MCP 工具列表\n\n### 通用工具（適用所有 Kibana）\n\n| 工具 | 說明 |\n|------|------|\n| `search_by_keyword` | 用關鍵字搜尋 log message |\n| `get_log_detail` | 用 `_id` 取得單筆 log 的完整內容 |\n| `refresh_cookie` | 手動刷新 session cookie |\n\n### 專用工具\n\n各團隊可在 `src/mcp/tools/<team-name>/` 下新增自己的工具，並在 `src/mcp/server.ts` 中註冊。專用工具不會隨 npm 套件發布。\n\n## 認證方式\n\n目前支援：\n\n- **Anonymous（匿名）** — 呼叫 `/internal/security/login` 取得 session cookie，適用於開啟 Guest 存取的 Kibana。401 時自動重新取得 session。\n\n其他認證方式（Basic Auth、API Key）規劃未來版本支援。\n\n## 設定檔位置\n\n| 範圍 | 路徑 | 用途 |\n|------|------|------|\n| 全域 | `~/.kibana-claude/config.json` | 跨專案共用設定 |\n| 專案 | `.kibana-claude/config.json` | 專案特定設定（優先於全域） |\n| Session | `~/.kibana-claude/sessions.json` | Session cookie（自動管理） |\n\n專案設定檔存在時會覆蓋全域設定。\n\n## Skills vs MCP — 如何選擇\n\n**Skills** 教 Claude Code 如何進行 log 分析（工作流程、查詢策略、輸出格式），是靜態 markdown 檔案，安裝到 `.claude/skills/`。\n\n**MCP Server** 賦予 Claude Code 實際執行查詢的能力，以 stdio 背景程序方式運行。\n\n**最佳實踐：兩者搭配使用。** Skills 引導 Claude 的分析思路，MCP 提供執行能力。\n\n## 專案結構\n\n```\nsrc/\n├── lib/                        # 核心函式庫（發布）\n│   ├── config.ts               # 設定載入與 session 管理\n│   ├── auth.ts                 # 認證（anonymous）\n│   ├── search.ts               # Kibana bsearch API 客戶端\n│   └── index.ts                # 公開 export 入口\n├── mcp/\n│   ├── server.ts               # MCP server 入口（發布）\n│   ├── formatter.ts            # Log 格式化與異常偵測\n│   └── tools/\n│       ├── generic/            # 通用工具（發布）\n│       │   └── search.ts\n│       └── kkday/              # 團隊專用工具（不發布）\n│           ├── search-by-uuid.ts\n│           ├── search-by-service.ts\n│           ├── search-by-product.ts\n│           ├── search-by-order.ts\n│           └── search-callback.ts\n└── cli/                        # CLI 指令（發布）\n    ├── index.ts\n    └── commands/\n        ├── init.ts\n        ├── test.ts\n        ├── auth.ts\n        ├── install-skills.ts\n        └── install-mcp.ts\nskills/\n└── templates/                  # Claude Code Skill 模板（發布）\n    ├── search-logs.md\n    ├── error-analysis.md\n    └── log-summary.md\n```\n\n## 開發\n\n```bash\n# 安裝依賴\nnpm install\n\n# 編譯\nnpm run build\n\n# 直接執行 MCP server（開發模式）\nnpm run dev\n```\n\n## 環境需求\n\n- Node.js >= 18\n- 能夠連線到你的 Kibana instance\n\n## License\n\nMIT\n","readmeFilename":"README.zh-TW.md","_rev":"1-d88afe2b58e7628793cf448a48c63dd1"}