Database · Developer Tools

Druid MCP Server

iunera/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.

Install

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.1

Client configuration

{
  "mcpServers": {
    "druid-mcp-server": {
      "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.1"
      ],
      "env": {
        "DRUID_ROUTER_URL": "<DRUID_ROUTER_URL>",
        "DRUID_COORDINATOR_URL": "<DRUID_COORDINATOR_URL>",
        "DRUID_AUTH_USERNAME": "<DRUID_AUTH_USERNAME>",
        "DRUID_AUTH_PASSWORD": "<DRUID_AUTH_PASSWORD>",
        "DRUID_SSL_ENABLED": "<DRUID_SSL_ENABLED>",
        "DRUID_SSL_SKIP_VERIFICATION": "<DRUID_SSL_SKIP_VERIFICATION>"
      }
    }
  }
}

Environment variables

DRUID_ROUTER_URLDRUID_COORDINATOR_URLDRUID_AUTH_USERNAMEDRUID_AUTH_PASSWORDDRUID_SSL_ENABLEDDRUID_SSL_SKIP_VERIFICATION
Author
@iunera
Category
Database, Developer Tools
Updated
Oct 6, 2026

Features

  • Spring AI MCP Server integration

  • Tool-based architecture for MCP protocol compliance

  • Tool-based Architecture: Complete MCP protocol compliance with automatic JSON schema generation

  • Multiple Transport Modes: STDIO, SSE, and Streamable HTTP support including Oauth

  • Real-time Communication: Server-Sent Events with streaming capabilities

  • Comprehensive error handling

  • Customizable Prompt Templates: AI-assisted guidance with template customization

  • Comprehensive Error Handling: Graceful error handling with meaningful responses

  • Enterprise Ready: Production-grade configuration and security features

Tools (29)

  • getDatasources

    List all available Apache Druid datasources or get detailed schema for a specific datasource.

  • getLookups

    Get configuration or status of lookups for all or a specific tier.

  • getSegments

    Fetch segments metadata or details for a specific segment.

  • getSegmentLoadQueue

    Get the load queue status showing segments currently being loaded.

  • queryDruidSql

    Execute a SQL query against Druid datasources.

  • getCompactionConfig

    View compaction configuration or configuration change history for datasources.

  • getCompactionStatus

    Retrieve the current status of compaction runs and progress.

  • manageCompaction

    Add, update, or remove a compaction configuration.

  • manageDatasourceOrSegment

    Modify segment states or permanently drop a datasource.

  • manageLookup

    Create, update, or delete a lookup configuration.

  • queryDruidMultiStage

    Execute a multi-stage SQL query (MSQ) against Druid datasources as a task.

  • queryDruidMultiStageWithContext

    Execute a multi-stage SQL query with custom context parameters.

  • getMultiStageQueryTaskStatus

    Get the status of a multi-stage query task.

  • cancelMultiStageQueryTask

    Cancel a running multi-stage query task.

  • getRetentionRules

    Retrieve retention rules or audit history for a specific datasource or all datasources.

  • manageRetentionRules

    Update retention rules configuration for a specific datasource.

  • submitIngestion

    Submit a Druid ingestion specification or generate a simple batch template.

  • getSupervisors

    List all supervisors or query details of a specific supervisor.

  • manageSupervisor

    Suspend, resume, or terminate a supervisor's execution.

  • getTasks

    List ingestion tasks matching specific states.

  • getTaskDetails

    Fetch detailed information, specifications, execution reports, or execution logs for a task.

  • shutdownTask

    Kill/shutdown a Druid task.

  • getClusterStatus

    Check overall health or fetch specific metadata/properties from coordinators or routers.

  • getNodesStatus

    List registered servers, their detailed status, or single node status.

  • diagnoseCluster

    Perform automated diagnostic health checks, configuration audits, or query performance analysis.

  • checkFunctionalityHealth

    Validate operations of ingestion systems, supervisor state transitions, and historical query latency.

  • manageAuthentication

    Administer basic security users and credentials.

  • manageAuthorization

    Manage security authorization properties, roles, and resource access policies.

  • manageSecurityAssignments

    Configure mapping rules assigning roles to users, or retrieve the configured authenticator chains.

Details on this page are taken from the project's README. Open README

Related MCP servers

More servers
Supabase MCP logo

Supabase MCP

supabase-community/supabase-mcp

1.3k

The Model Context Protocol (MCP) standardizes how Large Language Models (LLMs) talk to external services like Supabase. It connects AI assistants directly with your Supabase project and allows them to perform tasks like managing tables, fetching config, and querying data. See the full list of tools.

Database
Genai Toolbox logo

Genai Toolbox

googleapis/genai-toolbox

769

MCP Toolbox for Databases is an open source Model Context Protocol (MCP) server that connects your AI agents, IDEs, and applications directly to your enterprise databases.

Database
Supabase MCP Server logo

Supabase MCP Server

alexander-zuev/supabase-mcp-server

677

Query MCP is an open-source MCP server that lets your IDE safely run SQL, manage schema changes, call the Supabase Management API, and use Auth Admin SDK — all with built-in safety controls.

Database
Awesome MCP List logo

Awesome MCP List

MobinX/awesome-mcp-list

645

This is a continuously updated curated list of MCP servers, covering categories such as browser control, arts and culture, cloud platforms, command line, communication, customer data platforms, databases, developer tools, data science tools, file systems, finance and fintech, gaming, knowledge and memory, location services, marketing, monitoring, search and utilities. Each project includes a GitHub link and star count for quick reference and use.

Database
PostgreSQL Model Context Protocol (PG MCP) Server logo

PostgreSQL Model Context Protocol (PG MCP) Server

stuzero/pg-mcp-server

440

PG-MCP is a server implementation of the Model Context Protocol for PostgreSQL databases. It provides a comprehensive API for AI agents to discover, connect to, query, and understand PostgreSQL databases through MCP's resource-oriented architecture.

Database
dbhub logo

dbhub

bytebase/dbhub

332

[!NOTE] If you need an enterprise-level database MCP server with built-in guardrails like approval flow, access control, data masking, and audit logging beyond what DBHub offers, check out Bytebase.

Database