apache-druid

MCP server from AnilPuram/apache-druid-mcp-server

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio anilpuram-apache-druid-mcp-server npx apache-druid-mcp \
  --env DRUID_URL="https://your-druid-cluster.com:8888" \
  --env DRUID_TIMEOUT="30000" \
  --env DRUID_PASSWORD="your-password" \
  --env DRUID_USERNAME="your-username"

How to use

This MCP server provides a set of tools to interact with an Apache Druid cluster via Claude Desktop, VS Code, or other MCP clients. The server supports multiple transport methods (stdio by default and Server-Sent Events, SSE) and exposes actions to run SQL queries, list datasources, retrieve detailed metadata, and test connectivity to your Druid cluster. Typical usage is to start the MCP server with npx, configure the client (Claude or VS Code) to point at the server, and then issue commands like execute_sql_query, list_datasources, get_datasource_metadata, or test_connection to perform common data exploration and management tasks against Druid.

How to install

Prerequisites: Node.js and npm installed on your machine. Basic familiarity with running commands in a terminal or command prompt.

Install the MCP package and run via npx (recommended):

Ensure you have an active Node.js environment.
Run: npx apache-druid-mcp

Optional: Run via Docker (if provided by the project):

Pull the image: docker pull anilreddy399/apache-druid-mcp:latest
Run with default stdio transport: docker run -p 3000:3000 anilreddy399/apache-druid-mcp:latest
Run with SSE transport: docker run -p 3000:3000
-e DRUID_URL=https://your-druid-cluster.com:8888
-e DRUID_USERNAME=your-username
-e DRUID_PASSWORD=your-password
anilreddy399/apache-druid-mcp:latest --transport sse --port 3000

Environment preparation (if using npx or local development):

Optionally create a .env file or export environment variables such as DRUID_URL, DRUID_USERNAME, DRUID_PASSWORD, and DRUID_TIMEOUT as needed.

Local development workflow (optional):

Install dependencies and build if the project uses a build step: npm install npm run build
Start the server: npm start

Additional notes

Environment variables can be provided per client configuration or via the mcp configuration. Common variables include DRUID_URL (the Druid router/broker URL), DRUID_USERNAME and DRUID_PASSWORD for authentication, and DRUID_TIMEOUT to control request timeouts. The server supports both stdio and SSE transports; use SSE for HTTP-based clients and real-time streaming capabilities, and stdio for direct MCP client communication. If you encounter connection issues, verify network access to the Druid cluster, correct credentials, and that DRUID_URL uses the proper protocol (http/https) and port. The npm package name for this MCP server is apache-druid-mcp.

Related MCP Servers

zen

1.1k

Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage

MCP -Deepseek_R1

A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)

mcp-fhir

A Model Context Protocol implementation for FHIR

mcp

Inkdrop Model Context Protocol Server

mcp-appium-gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

dubco -npm

The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.