Apache Druid
A comprehensive Model Context Protocol (MCP) server for Apache Druid that provides extensive tools, resources, and AI-assisted prompts for managing and analyzing Druid clusters. Built with Spring Boot and Spring AI, this server enables seamless integ
What is Apache Druid?
Apache Druid is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to comprehensive model context protocol (mcp) server for apache druid that provides extensive tools, resources, and ai-assisted prompts for managing and analyzing druid clusters. built with spring boot a...
A comprehensive Model Context Protocol (MCP) server for Apache Druid that provides extensive tools, resources, and AI-assisted prompts for managing and analyzing Druid clusters. Built with Spring Boot and Spring AI, this server enables seamless integ
This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A comprehensive Model Context Protocol (MCP) server for Apac
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx druidConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Apache Druid
The Apache Druid MCP Server is a comprehensive Model Context Protocol server built with Spring Boot and Spring AI that exposes 60+ tools for managing and querying Apache Druid clusters. It supports datasource management, SQL execution, ingestion supervision, cluster health checks, security administration, and read-only mode — all accessible to AI agents via stdio or HTTP transport.
Prerequisites
- Java 25 and Maven 3.6+ (for building from source) or Docker
- A running Apache Druid cluster with the router accessible on port 8888
- Druid coordinator URL (default port 8081)
- An MCP-compatible AI client such as Claude Desktop or Claude Code
Pull and run the Docker image (recommended)
The fastest way to start is with the pre-built Docker image. Set the required DRUID_ROUTER_URL and DRUID_COORDINATOR_URL environment variables and run in interactive (-i) mode for stdio transport.
docker run --rm -i \
-e DRUID_ROUTER_URL=http://your-druid-router:8888 \
-e DRUID_COORDINATOR_URL=http://your-druid-coordinator:8081 \
iunera/druid-mcp-server:latestBuild from source (alternative)
If you prefer building locally, clone the repository, build with Maven, and run the resulting JAR file.
git clone https://github.com/iunera/druid-mcp-server.git
cd druid-mcp-server
mvn clean package -DskipTests
java -jar target/druid-mcp-server-1.8.2.jarConfigure authentication (optional)
If your Druid cluster requires authentication, pass credentials via environment variables. SSL can be enabled separately.
export DRUID_AUTH_USERNAME=admin
export DRUID_AUTH_PASSWORD=yourpassword
export DRUID_SSL_ENABLED=trueEnable read-only mode for safety
For production environments where you want agents to query but not modify the cluster, enable read-only mode. This blocks all write operations.
export DRUID_MCP_READONLY_ENABLED=true
java -jar target/druid-mcp-server-1.8.2.jarAdd the server to your MCP client config
Register the Docker-based server with Claude Desktop or Claude Code using the stdio transport. The container receives MCP messages via stdin/stdout.
Apache Druid Examples
Client configuration
Claude Desktop configuration using Docker to run the Druid MCP server in stdio mode with required environment variables.
{
"mcpServers": {
"druid": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "DRUID_ROUTER_URL=http://your-druid-router:8888",
"-e", "DRUID_COORDINATOR_URL=http://your-druid-coordinator:8081",
"iunera/druid-mcp-server:latest"
]
}
}
}Prompts to try
Once connected, use these prompts to interact with your Apache Druid cluster through the AI agent.
- "Check the health of my Druid cluster and list all datasources"
- "Run a SQL query: SELECT __time, page, added FROM wikipedia LIMIT 10"
- "List all active ingestion supervisors and their statuses"
- "Show me the segment count and total size for the 'wikipedia' datasource"
- "What retention rules are configured for the 'metrics' datasource?"Troubleshooting Apache Druid
Connection refused to Druid router or coordinator
Verify the URLs in DRUID_ROUTER_URL and DRUID_COORDINATOR_URL are reachable from the machine running the MCP server. If running in Docker, use the host machine's IP address instead of localhost (e.g., http://host.docker.internal:8888 on macOS/Windows).
Authentication errors with OAuth2
The server has OAuth2 enabled by default (DRUID_MCP_SECURITY_OAUTH2_ENABLED=true). If your Druid cluster does not use OAuth2, set this variable to false and use DRUID_AUTH_USERNAME and DRUID_AUTH_PASSWORD instead.
Write operations fail in read-only mode
If you set DRUID_MCP_READONLY_ENABLED=true, all state-changing tools are blocked by design. Set it to false and restart the server to re-enable write operations, or use a separate server instance for writes.
Frequently Asked Questions about Apache Druid
What is Apache Druid?
Apache Druid is a Model Context Protocol (MCP) server that comprehensive model context protocol (mcp) server for apache druid that provides extensive tools, resources, and ai-assisted prompts for managing and analyzing druid clusters. built with spring boot and spring ai, this server enables seamless integ It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Apache Druid?
Follow the installation instructions on the Apache Druid GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Apache Druid?
Apache Druid works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Apache Druid free to use?
Yes, Apache Druid is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Apache Druid Alternatives — Similar Analytics Servers
Looking for alternatives to Apache Druid? Here are other popular analytics servers you can use with Claude, Cursor, and VS Code.
OpenMetadata
★ 14.0kOpenMetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration.
Superset
★ 10.9kAn MCP server that provides AI assistants with full access to Apache Superset instances, enabling interaction with dashboards, charts, datasets, databases, and SQL execution capabilities.
Horizon
★ 4.4k📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 用 AI 构建你专属的新闻雷达
MCP Server Chart
★ 4.1kEnables generation of 25+ types of charts and data visualizations using AntV, including bar charts, line charts, maps, mind maps, and specialized diagrams like fishbone and sankey charts. Supports both statistical charts and geographic visualizations
Muapi CLI
★ 997Official CLI for muapi.ai — generate images, videos & audio from the terminal. MCP server, 14 AI models, npm + pip installable.
Weather MCP Server
★ 907Weather Data Fetcher MCP server built with Node.js, MCP SDK, and Zod. Provides weather details like temperature and forecast for cities such as Noida and Delhi via a registered tool. Simplifies API integration, enabling structured responses for clien
Browse More Analytics MCP Servers
Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Apache Druid in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Apache Druid?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.