Integrates with Apache Pinot to enable real-time analytics and metadata queries, allowing users to list tables/segments, execute SQL queries, view schema and column-level metadata, and perform data analysis on Pinot clusters.
Pinot MCP Server
Table of Contents
Overview
This project is a Python-based Model Context Protocol (MCP) server for interacting with Apache Pinot. It is designed to integrate with Claude Desktop to enable real-time analytics and metadata queries on a Pinot cluster.
It allows you to
- List tables, segments, and schema info from Pinot
- Execute read-only SQL queries
- View index/column-level metadata
- Designed to assist business users via Claude integration
- and much more.
Pinot MCP in Action
See Pinot MCP in action below:
Fetching Metadata
Fetching Data, followed by analysis
Prompt:
Can you do a histogram plot on the GitHub events against time
Sample Prompts
Once Claude is running, click the hammer 🛠️ icon and try these prompts:
- Can you help me analyse my data in Pinot? Use the Pinot tool and look at the list of tables to begin with.
- Can you do a histogram plot on the GitHub events against time
Quick Start
Prerequisites
Install uv (if not already installed)
uv is a fast Python package installer and resolver, written in Rust. It's designed to be a drop-in replacement for pip with significantly better performance.
Installation
Configure Pinot Cluster
The MCP server expects a uvicorn config style .env
file in the root directory to configure the Pinot cluster connection. This repo includes a sample .env.example
file that assumes a pinot quickstart setup.
Run the server
You should see logs indicating that the server is running and listening on STDIO.
Launch Pinot Quickstart (Optional)
Start Pinot QuickStart using docker:
Query MCP Server
This quickstart just checks all the tools and queries the airlineStats table.
Claude Desktop Integration
Open Claude's config file
Add an MCP server entry
Replace /path/to/uv
with the absolute path to the uv command, you can run which uv
to figure it out.
Replace /path/to/mcp-pinot
with the absolute path to the folder where you cloned this repo.
You could also configure environment variables here instead of the .env
file, in case you want to connect to multiple pinot clusters as MCP servers.
Restart Claude Desktop
Claude will now auto-launch the MCP server on startup and recognize the new Pinot-based tools.
Developer
- All tools are defined in the
Pinot
class inutils/pinot_client.py
Build
Build the project with
Test
Test the repo with:
Build the Docker image
Run the container
Note: Make sure to have your .env
file configured with the appropriate Pinot cluster settings before running the container.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
StarTree MCP Server for Apache Pinot
Related MCP Servers
- GoApache 2.0
- TypeScriptMIT License
- JavaScriptMIT License
- PythonMIT License