{
  "markdown": "[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/tocharianou-mcp-server-kibana-badge.png)](https://mseep.ai/app/tocharianou-mcp-server-kibana)\n\n# Kibana MCP Server\n[![npm version](https://badge.fury.io/js/@tocharianou%2Fmcp-server-kibana.svg)](https://www.npmjs.com/package/@tocharianou/mcp-server-kibana)\n[![Downloads](https://img.shields.io/npm/dm/@tocharianou/mcp-server-kibana.svg)](https://www.npmjs.com/package/@tocharianou/mcp-server-kibana)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/TocharianOU/mcp-server-kibana)\n\nA Kibana MCP server implementation that allows any MCP-compatible client (such as Claude Desktop) to access your Kibana instance via natural language or programmatic requests.\n\n> This project is based on the official Elastic Kibana API documentation and uses the OpenAPI YAML specification from Elastic Stack 8.x. For details, see the [Kibana API documentation](https://www.elastic.co/docs/api/doc/kibana/).\n\n**This project is community-maintained and is not an official product of Elastic or MCP.**\n\n> **💡 Companion Project:** For complete Elastic Stack integration, pair this with [**Elasticsearch MCP Server**](https://github.com/TocharianOU/mcp-server-elasticsearch-sl) for direct Elasticsearch data operations.\n\n---\n\n## 🚀 Installation\n\n```bash\n# Global installation (recommended)\nnpm install -g @tocharianou/mcp-server-kibana\n\n# Or use directly with npx\nnpx @tocharianou/mcp-server-kibana\n```\n\n### From Source\n```bash\ngit clone https://github.com/TocharianOU/mcp-server-kibana.git\ncd mcp-server-kibana\nnpm install && npm run build\n```\n\n---\n\n## 🎯 Quick Start\n\n### Claude Desktop Integration (Recommended)\n\nAdd to your Claude Desktop configuration file:\n- **MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"kibana\": {\n      \"command\": \"npx\",\n      \"args\": [\"@tocharianou/mcp-server-kibana\"],\n      \"env\": {\n        \"KIBANA_URL\": \"http://your-kibana-server:5601\",\n        \"KIBANA_API_KEY\": \"your-api-key\",\n        \"KIBANA_DEFAULT_SPACE\": \"default\"\n      }\n    }\n  }\n}\n```\n\n### Direct CLI Usage\n\n```bash\n# Using API Key (recommended)\nKIBANA_URL=http://localhost:5601 \\\nKIBANA_API_KEY=your-api-key \\\nnpx @tocharianou/mcp-server-kibana\n\n# Using Basic Auth\nKIBANA_URL=http://localhost:5601 \\\nKIBANA_USERNAME=your-username \\\nKIBANA_PASSWORD=your-password \\\nnpx @tocharianou/mcp-server-kibana\n\n# Using Cookie Auth\nKIBANA_URL=http://localhost:5601 \\\nKIBANA_COOKIES=\"sid=xxx; security-session=yyy\" \\\nnpx @tocharianou/mcp-server-kibana\n```\n\n### HTTP Mode (Remote Access)\n\n```bash\nMCP_TRANSPORT=http \\\nMCP_HTTP_PORT=3000 \\\nKIBANA_URL=http://localhost:5601 \\\nKIBANA_API_KEY=your-api-key \\\nnpx @tocharianou/mcp-server-kibana\n```\n\nAccess at: `http://localhost:3000/mcp`  \nHealth check: `http://localhost:3000/health`\n\n---\n\n## ✨ Features\n\n### Core Capabilities\n- **Dual transport modes**: Stdio (local) and HTTP (remote access)\n- **Multiple authentication methods**: API Key, Basic Auth, Cookie-based\n- **Multi-space support**: Enterprise-ready Kibana space management\n- **SSL/TLS support**: Custom CA certificate configuration\n- **Session management**: Automatic UUID generation for HTTP mode\n- **Dynamic API discovery**: Based on official Kibana OpenAPI specification\n\n### Saved Objects Management\n- Complete CRUD operations for all Kibana saved object types\n- Intelligent search with pagination support\n- Bulk operations for efficient mass updates\n- Version control with optimistic concurrency\n- Reference management for object relationships\n\n---\n\n## 🔧 Configuration\n\n### Required Variables\n\n| Variable | Description | Example |\n|----------|-------------|---------|\n| `KIBANA_URL` | Kibana server address | `http://localhost:5601` |\n\n### Authentication (choose one method)\n\n| Variable | Description | Priority |\n|----------|-------------|----------|\n| `KIBANA_API_KEY` | API Key (base64 encoded) | 1st |\n| `KIBANA_USERNAME` + `KIBANA_PASSWORD` | Basic authentication | 2nd |\n| `KIBANA_COOKIES` | Session cookies | 3rd |\n\n### Optional Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `KIBANA_DEFAULT_SPACE` | Default Kibana space | `default` |\n| `KIBANA_CA_CERT` | CA certificate path | - |\n| `KIBANA_TIMEOUT` | Request timeout (ms) | `30000` |\n| `MCP_TRANSPORT` | Transport mode | `stdio` |\n| `MCP_HTTP_PORT` | HTTP server port | `3000` |\n| `MCP_HTTP_HOST` | HTTP server host | `localhost` |\n| `NODE_TLS_REJECT_UNAUTHORIZED` | Disable SSL validation | `1` |\n\n---\n\n## 🛠️ Available Tools\n\n### Base Tools\n- `get_status` - Get Kibana server status\n- `execute_kb_api` - Execute custom Kibana API requests\n- `get_available_spaces` - List available Kibana spaces\n- `search_kibana_api_paths` - Search API endpoints\n- `list_all_kibana_api_paths` - List all API endpoints\n- `get_kibana_api_detail` - Get API endpoint details\n\n### Saved Objects Tools\n- `vl_search_saved_objects` - Search saved objects (universal)\n- `vl_get_saved_object` - Get single saved object\n- `vl_create_saved_object` - Create new saved object\n- `vl_update_saved_object` - Update single saved object\n- `vl_bulk_update_saved_objects` - Bulk update operations\n- `vl_bulk_delete_saved_objects` - Bulk delete operations\n\n**Supported Object Types:** dashboard, visualization, index-pattern, search, config, lens, map, tag, canvas-workpad, canvas-element\n\n### Analysis Tools (v0.6.0+)\n- `analyze_object_dependencies` - Analyze saved object dependencies\n- `analyze_deletion_impact` - Check impact before deletion\n- `check_dashboard_health` - Dashboard health check\n- `scan_all_dashboards_health` - Batch health scanning\n\n---\n\n## 📖 Resources\n\n| Resource URI | Description |\n|--------------|-------------|\n| `kibana-api://paths` | List all available API endpoints |\n| `kibana-api://paths?search=<keyword>` | Search endpoints by keyword |\n| `kibana-api://path/{method}/{encoded_path}` | Get specific endpoint details |\n\n---\n\n## 💬 Example Queries\n\n### Basic Operations\n- \"What is the status of my Kibana server?\"\n- \"List all available Kibana spaces\"\n- \"Show me all API endpoints related to dashboards\"\n\n### Saved Objects\n- \"Search for all dashboards\"\n- \"Find visualizations containing 'nginx' in the title\"\n- \"Create a new dashboard named 'Sales Overview'\"\n- \"Update the description of dashboard 'my-dashboard-123'\"\n- \"Delete multiple dashboards by their IDs\"\n\n### Health & Analysis\n- \"Check health of dashboard 'overview'\"\n- \"Analyze dependencies for visualization 'viz-123'\"\n- \"Scan all dashboards for health issues\"\n\n---\n\n## 🐛 Troubleshooting\n\n### Connection Issues\n- Verify Kibana URL is accessible\n- Check authentication credentials\n- For SSL issues: `NODE_TLS_REJECT_UNAUTHORIZED=0` (use with caution)\n\n### Claude Desktop Issues\n- Restart Claude Desktop after config changes\n- Validate JSON config syntax\n- Check console logs for errors\n\n### Common Errors\n- **\"import: command not found\"**: Update to latest version\n- **Authentication failed**: Verify credentials and permissions\n- **SSL errors**: Check CA certificate or disable SSL validation\n\n---\n\n## 🔍 Debugging\n\nUse MCP Inspector for debugging:\n\n```bash\nnpm run inspector\n```\n\nThis provides a browser-accessible debugging interface.\n\n---\n\n## 📦 Package Information\n\n- **NPM**: [@tocharianou/mcp-server-kibana](https://www.npmjs.com/package/@tocharianou/mcp-server-kibana)\n- **GitHub**: [TocharianOU/mcp-server-kibana](https://github.com/TocharianOU/mcp-server-kibana)\n- **Node.js**: >= 18.0.0\n- **License**: Apache 2.0\n\n---\n\n## 🤝 Contributing\n\nThis project is community-maintained. Contributions and feedback are welcome!\n\nPlease follow the [Elastic Community Code of Conduct](https://www.elastic.co/community/codeofconduct) in all communications.\n\n---\n\n## 📄 License\n\nApache License 2.0 - See [LICENSE](LICENSE) file for details.\n",
  "bytes": 7866,
  "sha": "e43a46b2dec9c8fc96d641eaf4742142afaf45441662b53ac909255db3993c70",
  "repo_slug": "tocharianou/mcp-server-kibana",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tocharianou_kibana_32c4b6f2/readme"
}