startreedata/mcp-pinot

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

17 stars 13 forks 品質 84 トレンド 41Apache-2.0

Repository Install

Apache Pinot の MCP サーバー

概要

このプロジェクトは、Apache Pinot とやり取りするための Python ベースのモデルコンテキストプロトコル (MCP) サーバです。 FastMCPフレームワークを使用して構築されます。 Claude Desktopと統合して、Pinot クラスターのリアルタイム分析とメタデータクエリを有効にします。これにより、Pinotからテーブル、セグメント、およびスキーマ情報をリスト - 読み取り専用のSQLクエリを実行 - インデックス/列レベルのメタデータ - Claudeインテグレーションを介してビジネスユーザーを支援するために設計された - など。 - すべてのツールは、エージェントの計画のための入力と出力JSONスキーマ、MCPリスクアノテーション、および失敗回復ガイダンスを広告しています。 - 大規模なクエリ、テーブル、セグメント名、およびセグメント・メタデータ応答は、未入力のエージェントコンテキストを返す代わりに、継続したメタデータを持つ境界ページを使用します。 - 読み取り専用SQLは、実行前に解析および強制されます。検証、許可、および一時的な接続エラーは、実用的なMCPエラーとして解釈されます.

概要（AI 翻訳）

コンテンツの表

概要
特徴
クイックスタート
構成の参照
Dockerビルド
クロードデスクトップの統合
プロンプトを試してみる
セキュリティと脆弱性の報告
開発者ノート
リポ・メンテナー

概要

このプロジェクトは、Apache Pinot とやり取りするための Python ベースのモデルコンテキストプロトコル (MCP) サーバです。 FastMCPフレームワークを使用して構築されます。 Claude Desktopと統合して、Pinot クラスターのリアルタイム分析とメタデータクエリを有効にします。

それはあなたがすることができます

リストテーブル、セグメント、およびピノからのスキーマ情報
読み取り専用SQLクエリを実行
インデックス/カラムレベルのメタデータを表示
Claudeの統合によってビジネスユーザーを支援する設計・その他

##特徴

すべてのツールは、タイプされた入力と出力JSONシーン、MCPリスクアノテーションを広告します。エージェント計画の失敗回復ガイダンス。
大規模なクエリ、テーブル、セグメント名、セグメント・メタデータ・レスポンスの境界非結合されたエージェントのコンテキストを返す代わりに、継続メタデータを持つページ。
読み取り専用SQLは実行前に解析され、強制されます。検証、許可、接続エラーがアクション可能なMCPエラーとして解釈されます.

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Pinot MCP Server

Overview
Features
Quick Start
Configuration Reference
Docker Build
Claude Desktop Integration
Try a Prompt
Security and Vulnerability Reporting
Developer Notes
Repo Maintainer

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.

GitHub で README 全文を見る

インストール

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
          }
      }
  }
}