Для чего этот сервер?

Этот MCP-сервер подключает AI-помощников к Apache Druid. Он даёт возможность общаться с кластером на естественном языке: спрашивать про данные, запускать загрузку, проверять состояние — без ручного написания Druid SQL. Аналитики экономят время на рутине, а разработчики быстрее решают задачи администрирования через чат.

Каталог MCP
iunera/druid-mcp-server

iunera/druid-mcp-server

от iunera

MCP-сервер для Apache Druid: инструменты, ресурсы и промпты для управления кластерами, SQL-запросов, настройки ингредиентов и мониторинга здоровья. Даёт AI-ассистентам возможность управлять и анали...

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

Druid MCP Server

A comprehensive Model Context Protocol (MCP) server for Apache Druid that provides extensive tools, resources, and prompts for managing and analyzing Druid clusters.

Developed by iunera - Advanced AI and Data Analytics Solutions

Overview

This MCP server implements a intend-based architecture where profiles picture their usaae intend and the corresponding area of Druid usage. The server provides three main types of MCP components:

Tools - Executable functions for performing operations
Resources - Data providers for accessing information
Prompts - AI-assisted guidance templates

Video Walkthrough

Learn how to integrate AI agents with Apache Druid using the MCP server. This tutorial demonstrates time series data exploration, statistical analysis, and data ingestion using natural language with AI assistants like Claude, ChatGPT, and Gemini.

Click the thumbnail above to watch the video on YouTube

🌊 Y̊pipe: AI-Powered UI for Druid

Experience your data like never before with Y̊pipe (formerly Data-Philter), a local desktop application that makes offline AI practical, designed by iunera. It leverages this Druid MCP Server to provide a seamless, conversational interface for your Druid cluster.

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить iunera/druid-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "iunera-druid-mcp-server-wqk03sp2s8": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DRUID_ROUTER_URL",
        "-e",
        "DRUID_COORDINATOR_URL",
        "-e",
        "DRUID_AUTH_USERNAME",
        "-e",
        "DRUID_AUTH_PASSWORD",
        "-e",
        "DRUID_SSL_ENABLED",
        "-e",
        "DRUID_SSL_SKIP_VERIFICATION",
        "iunera/druid-mcp-server:2.0.0"
      ],
      "env": {
        "DRUID_ROUTER_URL": "http://host.docker.internal:8888",
        "DRUID_COORDINATOR_URL": "http://host.docker.internal:8081",
        "DRUID_AUTH_USERNAME": "",
        "DRUID_AUTH_PASSWORD": "",
        "DRUID_SSL_ENABLED": "false",
        "DRUID_SSL_SKIP_VERIFICATION": "true"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "iunera-druid-mcp-server-wqk03sp2s8": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DRUID_ROUTER_URL",
        "-e",
        "DRUID_COORDINATOR_URL",
        "-e",
        "DRUID_AUTH_USERNAME",
        "-e",
        "DRUID_AUTH_PASSWORD",
        "-e",
        "DRUID_SSL_ENABLED",
        "-e",
        "DRUID_SSL_SKIP_VERIFICATION",
        "iunera/druid-mcp-server:2.0.0"
      ],
      "env": {
        "DRUID_ROUTER_URL": "http://host.docker.internal:8888",
        "DRUID_COORDINATOR_URL": "http://host.docker.internal:8081",
        "DRUID_AUTH_USERNAME": "",
        "DRUID_AUTH_PASSWORD": "",
        "DRUID_SSL_ENABLED": "false",
        "DRUID_SSL_SKIP_VERIFICATION": "true"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "iunera-druid-mcp-server-wqk03sp2s8": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DRUID_ROUTER_URL",
        "-e",
        "DRUID_COORDINATOR_URL",
        "-e",
        "DRUID_AUTH_USERNAME",
        "-e",
        "DRUID_AUTH_PASSWORD",
        "-e",
        "DRUID_SSL_ENABLED",
        "-e",
        "DRUID_SSL_SKIP_VERIFICATION",
        "iunera/druid-mcp-server:2.0.0"
      ],
      "env": {
        "DRUID_ROUTER_URL": "http://host.docker.internal:8888",
        "DRUID_COORDINATOR_URL": "http://host.docker.internal:8081",
        "DRUID_AUTH_USERNAME": "",
        "DRUID_AUTH_PASSWORD": "",
        "DRUID_SSL_ENABLED": "false",
        "DRUID_SSL_SKIP_VERIFICATION": "true"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"iunera-druid-mcp-server-wqk03sp2s8\",\"type\":\"stdio\",\"command\":\"docker\",\"args\":[\"run\",\"--rm\",\"-i\",\"-e\",\"DRUID_ROUTER_URL\",\"-e\",\"DRUID_COORDINATOR_URL\",\"-e\",\"DRUID_AUTH_USERNAME\",\"-e\",\"DRUID_AUTH_PASSWORD\",\"-e\",\"DRUID_SSL_ENABLED\",\"-e\",\"DRUID_SSL_SKIP_VERIFICATION\",\"iunera/druid-mcp-server:2.0.0\"],\"env\":{\"DRUID_ROUTER_URL\":\"http://host.docker.internal:8888\",\"DRUID_COORDINATOR_URL\":\"http://host.docker.internal:8081\",\"DRUID_AUTH_USERNAME\":\"\",\"DRUID_AUTH_PASSWORD\":\"\",\"DRUID_SSL_ENABLED\":\"false\",\"DRUID_SSL_SKIP_VERIFICATION\":\"true\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "iunera-druid-mcp-server-wqk03sp2s8": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DRUID_ROUTER_URL",
        "-e",
        "DRUID_COORDINATOR_URL",
        "-e",
        "DRUID_AUTH_USERNAME",
        "-e",
        "DRUID_AUTH_PASSWORD",
        "-e",
        "DRUID_SSL_ENABLED",
        "-e",
        "DRUID_SSL_SKIP_VERIFICATION",
        "iunera/druid-mcp-server:2.0.0"
      ],
      "env": {
        "DRUID_ROUTER_URL": "http://host.docker.internal:8888",
        "DRUID_COORDINATOR_URL": "http://host.docker.internal:8081",
        "DRUID_AUTH_USERNAME": "",
        "DRUID_AUTH_PASSWORD": "",
        "DRUID_SSL_ENABLED": "false",
        "DRUID_SSL_SKIP_VERIFICATION": "true"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add iunera-druid-mcp-server-wqk03sp2s8 --env DRUID_ROUTER_URL=http://host.docker.internal:8888 --env DRUID_COORDINATOR_URL=http://host.docker.internal:8081 --env DRUID_AUTH_USERNAME= --env DRUID_AUTH_PASSWORD= --env DRUID_SSL_ENABLED=false --env DRUID_SSL_SKIP_VERIFICATION=true -- docker run --rm -i -e DRUID_ROUTER_URL -e DRUID_COORDINATOR_URL -e DRUID_AUTH_USERNAME -e DRUID_AUTH_PASSWORD -e DRUID_SSL_ENABLED -e DRUID_SSL_SKIP_VERIFICATION iunera/druid-mcp-server:2.0.0

Либо через JSON-конфиг:

claude mcp add-json iunera-druid-mcp-server-wqk03sp2s8 "{\"command\":\"docker\",\"args\":[\"run\",\"--rm\",\"-i\",\"-e\",\"DRUID_ROUTER_URL\",\"-e\",\"DRUID_COORDINATOR_URL\",\"-e\",\"DRUID_AUTH_USERNAME\",\"-e\",\"DRUID_AUTH_PASSWORD\",\"-e\",\"DRUID_SSL_ENABLED\",\"-e\",\"DRUID_SSL_SKIP_VERIFICATION\",\"iunera/druid-mcp-server:2.0.0\"],\"env\":{\"DRUID_ROUTER_URL\":\"http://host.docker.internal:8888\",\"DRUID_COORDINATOR_URL\":\"http://host.docker.internal:8081\",\"DRUID_AUTH_USERNAME\":\"\",\"DRUID_AUTH_PASSWORD\":\"\",\"DRUID_SSL_ENABLED\":\"false\",\"DRUID_SSL_SKIP_VERIFICATION\":\"true\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add iunera-druid-mcp-server-wqk03sp2s8 --env DRUID_ROUTER_URL=http://host.docker.internal:8888 --env DRUID_COORDINATOR_URL=http://host.docker.internal:8081 --env DRUID_AUTH_USERNAME= --env DRUID_AUTH_PASSWORD= --env DRUID_SSL_ENABLED=false --env DRUID_SSL_SKIP_VERIFICATION=true -- docker run --rm -i -e DRUID_ROUTER_URL -e DRUID_COORDINATOR_URL -e DRUID_AUTH_USERNAME -e DRUID_AUTH_PASSWORD -e DRUID_SSL_ENABLED -e DRUID_SSL_SKIP_VERIFICATION iunera/druid-mcp-server:2.0.0

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.iunera-druid-mcp-server-wqk03sp2s8]
command = "docker"
args = ["run", "--rm", "-i", "-e", "DRUID_ROUTER_URL", "-e", "DRUID_COORDINATOR_URL", "-e", "DRUID_AUTH_USERNAME", "-e", "DRUID_AUTH_PASSWORD", "-e", "DRUID_SSL_ENABLED", "-e", "DRUID_SSL_SKIP_VERIFICATION", "iunera/druid-mcp-server:2.0.0"]

[mcp_servers.iunera-druid-mcp-server-wqk03sp2s8.env]
DRUID_ROUTER_URL = "http://host.docker.internal:8888"
DRUID_COORDINATOR_URL = "http://host.docker.internal:8081"
DRUID_AUTH_USERNAME = ""
DRUID_AUTH_PASSWORD = ""
DRUID_SSL_ENABLED = "false"
DRUID_SSL_SKIP_VERIFICATION = "true"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите iunera/druid-mcp-server, а в поле команды запуска — строку ниже:

docker run --rm -i -e DRUID_ROUTER_URL -e DRUID_COORDINATOR_URL -e DRUID_AUTH_USERNAME -e DRUID_AUTH_PASSWORD -e DRUID_SSL_ENABLED -e DRUID_SSL_SKIP_VERIFICATION iunera/druid-mcp-server:2.0.0

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "iunera-druid-mcp-server-wqk03sp2s8": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DRUID_ROUTER_URL",
        "-e",
        "DRUID_COORDINATOR_URL",
        "-e",
        "DRUID_AUTH_USERNAME",
        "-e",
        "DRUID_AUTH_PASSWORD",
        "-e",
        "DRUID_SSL_ENABLED",
        "-e",
        "DRUID_SSL_SKIP_VERIFICATION",
        "iunera/druid-mcp-server:2.0.0"
      ],
      "env": {
        "DRUID_ROUTER_URL": "http://host.docker.internal:8888",
        "DRUID_COORDINATOR_URL": "http://host.docker.internal:8081",
        "DRUID_AUTH_USERNAME": "",
        "DRUID_AUTH_PASSWORD": "",
        "DRUID_SSL_ENABLED": "false",
        "DRUID_SSL_SKIP_VERIFICATION": "true"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "iunera-druid-mcp-server-wqk03sp2s8": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DRUID_ROUTER_URL",
        "-e",
        "DRUID_COORDINATOR_URL",
        "-e",
        "DRUID_AUTH_USERNAME",
        "-e",
        "DRUID_AUTH_PASSWORD",
        "-e",
        "DRUID_SSL_ENABLED",
        "-e",
        "DRUID_SSL_SKIP_VERIFICATION",
        "iunera/druid-mcp-server:2.0.0"
      ],
      "env": {
        "DRUID_ROUTER_URL": "http://host.docker.internal:8888",
        "DRUID_COORDINATOR_URL": "http://host.docker.internal:8081",
        "DRUID_AUTH_USERNAME": "",
        "DRUID_AUTH_PASSWORD": "",
        "DRUID_SSL_ENABLED": "false",
        "DRUID_SSL_SKIP_VERIFICATION": "true"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например iunera-druid-mcp-server-wqk03sp2s8.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: iunera-druid-mcp-server-wqk03sp2s8
    command: docker
    args:
      - "run"
      - "--rm"
      - "-i"
      - "-e"
      - "DRUID_ROUTER_URL"
      - "-e"
      - "DRUID_COORDINATOR_URL"
      - "-e"
      - "DRUID_AUTH_USERNAME"
      - "-e"
      - "DRUID_AUTH_PASSWORD"
      - "-e"
      - "DRUID_SSL_ENABLED"
      - "-e"
      - "DRUID_SSL_SKIP_VERIFICATION"
      - "iunera/druid-mcp-server:2.0.0"
    env:
      DRUID_ROUTER_URL: http://host.docker.internal:8888
      DRUID_COORDINATOR_URL: http://host.docker.internal:8081
      DRUID_AUTH_USERNAME: 
      DRUID_AUTH_PASSWORD: 
      DRUID_SSL_ENABLED: false
      DRUID_SSL_SKIP_VERIFICATION: true

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "iunera-druid-mcp-server-wqk03sp2s8": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DRUID_ROUTER_URL",
        "-e",
        "DRUID_COORDINATOR_URL",
        "-e",
        "DRUID_AUTH_USERNAME",
        "-e",
        "DRUID_AUTH_PASSWORD",
        "-e",
        "DRUID_SSL_ENABLED",
        "-e",
        "DRUID_SSL_SKIP_VERIFICATION",
        "iunera/druid-mcp-server:2.0.0"
      ],
      "env": {
        "DRUID_ROUTER_URL": "http://host.docker.internal:8888",
        "DRUID_COORDINATOR_URL": "http://host.docker.internal:8081",
        "DRUID_AUTH_USERNAME": "",
        "DRUID_AUTH_PASSWORD": "",
        "DRUID_SSL_ENABLED": "false",
        "DRUID_SSL_SKIP_VERIFICATION": "true"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "-e",
    "DRUID_ROUTER_URL",
    "-e",
    "DRUID_COORDINATOR_URL",
    "-e",
    "DRUID_AUTH_USERNAME",
    "-e",
    "DRUID_AUTH_PASSWORD",
    "-e",
    "DRUID_SSL_ENABLED",
    "-e",
    "DRUID_SSL_SKIP_VERIFICATION",
    "iunera/druid-mcp-server:2.0.0"
  ],
  "env": {
    "DRUID_ROUTER_URL": "http://host.docker.internal:8888",
    "DRUID_COORDINATOR_URL": "http://host.docker.internal:8081",
    "DRUID_AUTH_USERNAME": "",
    "DRUID_AUTH_PASSWORD": "",
    "DRUID_SSL_ENABLED": "false",
    "DRUID_SSL_SKIP_VERIFICATION": "true"
  }
}