Druid Mcp Server
by iuneraofficialv1.8.2
15
7
An MCP server for Apache Druid that exposes tools, resources, and prompts to inspect, query, and manage Druid clusters. It supports cluster health checks, datasource/segment/lookup management, ingestion supervision, and SQL querying over multiple transports including STDIO, SSE, and streamable HTTP.
From the registry: AI-powered MCP server for Apache Druid cluster management and analytic
Install & configure
Prerequisites
- requiredApache Druid clusterYou need a running Apache Druid cluster (router + coordinator).https://druid.apache.org/
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `druid-mcp-server` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Apache Druid cluster** — You need a running Apache Druid cluster (router + coordinator). (https://druid.apache.org/)
Canonical MCP server config (stdio transport):
- 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","-e","DRUID_MCP_READONLY_ENABLED","iunera/druid-mcp-server:latest"]
- required environment variables:
- `DRUID_ROUTER_URL`: URL of the Druid router (e.g. http://localhost:8888). (example: `<your-druid-router-url>`)
- optional environment variables:
- `DRUID_COORDINATOR_URL`: URL of the Druid coordinator (e.g. http://localhost:8081). (example: `<your-druid-coordinator-url>`)
- `DRUID_AUTH_USERNAME`: Username for Druid basic auth, if enabled. (example: `<your-druid-username>`)
- `DRUID_AUTH_PASSWORD`: Password for Druid basic auth, if enabled. (example: `<your-druid-password>`)
- `DRUID_SSL_ENABLED`: Enable SSL for Druid connections (true/false). (example: `false`)
- `DRUID_SSL_SKIP_VERIFICATION`: Skip SSL certificate verification (true/false). Only for testing. (example: `false`)
- `DRUID_MCP_READONLY_ENABLED`: Enable read-only mode (true/false). (example: `false`)
Note: Spring Boot MCP server for Apache Druid. Docker is the simplest path; also runnable as `java -jar druid-mcp-server-*.jar` and supports STDIO, SSE, and Streamable HTTP transports.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Spring Boot MCP server for Apache Druid. Docker is the simplest path; also runnable as `java -jar druid-mcp-server-*.jar` and supports STDIO, SSE, and Streamable HTTP transports.
Tools (37)
listDatasources
List all available Druid datasource names
showDatasourceDetails
Show detailed information for a specific datasource including column information
killDatasource
Kill a datasource permanently, removing all data and metadata
listLookups
List all available Druid lookups from the coordinator
getLookupConfig
Get configuration for a specific lookup
updateLookupConfig
Update configuration for a specific lookup
listAllSegments
List all segments across all datasources
getSegmentMetadata
Get metadata for specific segments
getSegmentsForDatasource
Get all segments for a specific datasource
queryDruidSql
Execute a SQL query against Druid datasources
viewRetentionRules
View retention rules for all datasources or a specific one
updateRetentionRules
Update retention rules for a datasource
viewAllCompactionConfigs
View compaction configurations for all datasources
Environment variables
DRUID_ROUTER_URLrequiredURL of the Apache Druid router used by the server to connect to the clusterDRUID_COORDINATOR_URLrequiredURL of the Apache Druid coordinator used by the server to connect to the clusterDRUID_MCP_SECURITY_OAUTH2_ENABLEDrequiredEnables or disables OAuth2 security for client authenticationSPRING_PROFILES_ACTIVESelects the transport mode profile, such as http for streamable HTTPPackages
docker.io/iunera/druid-mcp-server:1.8.2
ocitransport: stdio
Details
- Language
- Java
- License
- Apache-2.0
- Released
- Mar 26, 2026
- Last commit
- Jun 30, 2026
- Registry name
- com.iunera/druid-mcp-server