Druid MCP Server

Druid MCP Server

A comprehensive MCP server for Apache Druid providing tools, resources, and prompts for managing and analyzing Druid clu

9
Stars
4
Forks
12
Releases

Overview

The Druid MCP Server is a feature-based MCP server built on the Spring AI MCP Server framework. It exposes Tools, Resources, and Prompts organized by distinct Druid management areas (data management, ingestion management, monitoring & health, and security). The server auto-discovers and registers tools, resources, and prompts via annotations, enabling automatic MCP protocol compliance with generated JSON schemas. It supports multiple transports—STDIO, Server-Sent Events (SSE), and Streamable HTTP—with OAuth protection and real-time streaming capabilities. A robust inspector interface (MCP Inspector) shows available tools, resources, and prompts and each category is complemented by example operations and documentation. Prompt customization is supported through prompts.properties with runtime overrides via -D system properties or a custom properties file. The server includes extensive security features (OAuth2 by default, with enterprise SSO options), a read-only mode for safe operations, and a catalog of tools/resources/prompts across core features such as Data Management, Ingestion Management, Monitoring & Health, and Basic Security. It is designed for enterprise Druid operations and AI-assisted workflows, with ready-made configurations and Docker/Maven Central delivery.

Details

Owner
iunera
Language
Java
License
Apache License 2.0
Updated
2025-12-07

Features

Spring AI MCP Server integration

Integrates the MCP server with the Spring AI MCP Server framework to enable streamlined development, deployment, and MCP exposure.

Tool-based architecture for MCP protocol compliance

Exposes executable tools that conform to the MCP protocol, with automatic JSON schema generation for client interoperability.

Auto-discovery via annotations

Automatically registers tools, resources, and prompts through annotation-based discovery.

Multi-transport modes

Supports STDIO, Server-Sent Events (SSE), and Streamable HTTP with OAuth protection for MCP communication.

Real-time communication via SSE

Provides real-time streaming capabilities through Server-Sent Events for dynamic MCP interactions.

Customizable prompt templates

Prompts can be customized via prompts.properties and overridden at runtime or via a custom properties file.

Robust error handling

Offers comprehensive error handling with meaningful, user-friendly responses across MCP operations.

Read-only mode

Enables a read-only configuration that disables mutating tools while preserving read operations and SQL queries.

Audience

Data EngineersManage and analyze Druid clusters using MCP tools, resources, and prompts.
LLM IntegratorsIntegrate AI agents with Druid via MCP for guided workflows.
Enterprise ITSecure, scalable MCP server deployment for enterprise Druid operations.

Tags

Apache DruidMCP ServerMCPToolsResourcesPromptsStreamable HTTPSSEOAuth2Auto-discoveryPrompt customizationRead-only modeSecuritySpring AIMCP Inspector