Kibana MCP Server

Kibana MCP Server

Kibana Security 用の Model Context Protocol（MCP）サーバーです。AI アシスタントを通じて、アラート、ルール、例外を管理できます。

クイックスタート

1. クローンしてビルドする

git clone https://github.com/ggilligan12/kibana-mcp.git
cd kibana-mcp
docker build -t kibana-mcp .

2. MCP クライアントを設定する

MCP クライアントの設定（Claude Desktop、Cursor など）に追加します。

オプション A：環境変数を使用する（推奨）

まず、認証情報を設定します。

export KIBANA_URL="https://your-kibana.example.com:5601"

# Option 1: API Key (recommended)
export KIBANA_API_KEY="your_base64_api_key"

# Option 2: Username/Password
# export KIBANA_USERNAME="your_username"
# export KIBANA_PASSWORD="your_password"

次に、MCP の設定に追加します。

{
  "mcpServers": {
    "kibana-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--network", "host", "-e", "KIBANA_URL", "-e", "KIBANA_API_KEY", "kibana-mcp"]
    }
  }
}

ユーザー名とパスワードを使用する場合は、次のようにします。

{
  "mcpServers": {
    "kibana-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--network", "host", "-e", "KIBANA_URL", "-e", "KIBANA_USERNAME", "-e", "KIBANA_PASSWORD", "kibana-mcp"]
    }
  }
}

オプション B：認証情報を直接指定する（Claude Desktop では簡単）

API キーを使用する場合：

{
  "mcpServers": {
    "kibana-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--network", "host",
        "-e", "KIBANA_URL=https://your-kibana.example.com:5601",
        "-e", "KIBANA_API_KEY=your_base64_api_key",
        "kibana-mcp"
      ]
    }
  }
}

ユーザー名とパスワードを使用する場合：

{
  "mcpServers": {
    "kibana-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--network", "host",
        "-e", "KIBANA_URL=https://your-kibana.example.com:5601",
        "-e", "KIBANA_USERNAME=your_username",
        "-e", "KIBANA_PASSWORD=your_password",
        "kibana-mcp"
      ]
    }
  }
}

注：オプション B は安全性が低くなりますが、環境変数の管理が難しい Claude Desktop などのツールでは、より便利です。

利用可能なツール

• get_alerts - セキュリティアラートを取得します
• tag_alert - アラートにタグを追加します
• adjust_alert_status - アラートのステータスを変更します（open／acknowledged／closed）
• find_rules - 検出ルールを検索します
• get_rule_exceptions - ルールの例外項目を取得します
• add_rule_exception_items - ルールに例外を追加します
• create_exception_list - 新しい例外リストを作成します
• associate_shared_exception_list - 例外リストをルールに関連付けます

ローカル開発

# Install dependencies
uv sync

# Set environment variables (see above)

# Run locally
uv run kibana-mcp

テスト環境

# Start local Kibana/Elasticsearch with test data
pip install -r testing/requirements-dev.txt
./testing/quickstart-test-env.sh

# Access at http://localhost:5601 (elastic/elastic)