MMCPMarkets
SM

startreedata/mcp-pinot

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

17 stars 13 forks Качество 84 Тренд 41Apache-2.0
Repository Install

MCP-сервер для Apache Pinot

Обзор

Этот проект представляет собой сервер на базе Python Model Context Protocol (MCP) для взаимодействия с Apache Pinot. Он построен с использованием фреймворка FastMCP. Он предназначен для интеграции с Claude Desktop для обеспечения аналитики в реальном времени и запросов метаданных в кластере Pinot. Он позволяет - Перечислить таблицы, сегменты и информацию о схеме от Pinot - Исполнить только для чтения SQL-запросы - Просмотр метаданных на уровне индекса / колонки - Разработан для помощи бизнес-пользователям через интеграцию Claude - и многое другое. Каждый инструмент рекламирует типизированные схемы ввода и вывода JSON, аннотации риска MCP и рекомендации по восстановлению после сбоев для планирования агента. Большие ответы на запросы, таблицы, имена сегментов и метаданные сегментов используют ограниченные страницы с метаданными продолжения вместо возвращения контекста неограниченного агента. SQL только для чтения анализируется и выполняется перед выполнением; валидация, разрешение и временные ошибки подключения всплывают в качестве действенных ошибок MCP.

Обзор (машинный перевод)

Таблица содержимого

  • Обзор
  • Особенности Быстрый старт
  • Ссылка на конфигурацию
  • Docker Build Интеграция Claude Desktop
  • Попробуй быстро Отчетность по безопасности и уязвимости Разработчик Notes
  • Repo Maintainer

Обзор

Этот проект представляет собой сервер на базе Python Model Context Protocol (MCP) для взаимодействия с Apache Pinot. Он построен с использованием фреймворка FastMCP. Он предназначен для интеграции с Claude Desktop для обеспечения аналитики в реальном времени и запросов метаданных в кластере Pinot.

Это позволяет вам

  • Список таблиц, сегментов и информации о схеме от Pinot Выполнять только для чтения SQL-запросы
  • Просмотр метаданных индекса/колонного уровня Предназначен для помощи бизнес-пользователям через интеграцию с Claude
  • и многое другое.

Особенности

  • Каждый инструмент рекламирует типизированные схемы ввода и вывода JSON, аннотации рисков MCP, Руководство по восстановлению после неудач для планирования агента. Большие запросы, таблица, имя сегмента и ответы сегмент-метадата используют ограниченные страницы с метаданными продолжения, вместо того чтобы возвращать неограниченный контекст агента.
  • SQL только для чтения анализируется и выполняется перед выполнением; проверка, разрешение, и временные ошибки подключения всплывают как действенные ошибки MCP.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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 built using the FastMCP framework. 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.

Features

  • Every tool advertises typed input and output JSON Schemas, MCP risk annotations, and failure-recovery guidance for agent planning.
  • Large query, table, segment-name, and segment-metadata responses use bounded pages with continuation metadata instead of returning unbounded agent context.
  • Read-only SQL is parsed and enforced before execution; validation, permission, and transient connectivity errors are surfaced as actionable MCP errors.
  • Every mutating tool supports dry_run; always preview the exact target and payload before applying. Applying requires the preview’s short-lived, one-time confirmation_token, including for table-filter reloads. A preview is not a guarantee that Pinot will accept the later write.
  • Single-purpose schema and table-config inspection tools avoid ambiguous combined operations: use get_schema and get_table_config independently.

MCP Tool Contract

Tool names are case-sensitive and use underscores. Version 4 renamed four tools to make every operation verb-first; clients using the former noun-first names must update their calls.

Tool Purpose
test_connection Diagnose broker, controller, and query connectivity.
list_tables List visible Pinot table names.
get_schema Get one table’s column schema.
Открыть полный README на GitHub

Установка

docker run --name pinot-quickstart -p 2123:2123 -p 9000:9000 -p 8000:8000 -d apachepinot/pinot:1.5.1 QuickStart -type batch
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "pinot_mcp": { "command": "/path/to/uv", "args": [ "--directory", "/path/to/mcp-pinot-repo", "run", "mcp_pinot/server.py" ], "env": { // You can also include your .env config here } } } }