MCP Pinot

🚀 Pinot MCP Server

このプロジェクトは、Apache Pinotとやり取りするためのPythonベースのModel Context Protocol (MCP)サーバーです。Claude Desktopと統合し、Pinotクラスターに対するリアルタイム分析とメタデータクエリを可能にするように設計されています。

📚 目次

• 概要
• 主な機能
• クイックスタート
• Dockerビルド
• Claude Desktopとの統合
• プロンプトの試用
• 開発者向けメモ

概要

このプロジェクトは、Apache Pinotとやり取りするためのPythonベースのModel Context Protocol (MCP)サーバーです。Claude Desktopと統合し、Pinotクラスターに対するリアルタイム分析とメタデータクエリを可能にするように設計されています。

以下のことが可能です。

• Pinotからテーブル、セグメント、スキーマ情報をリストアップする
• 読み取り専用のSQLクエリを実行する
• インデックス/カラムレベルのメタデータを表示する
• Claudeとの統合を通じてビジネスユーザーを支援するように設計されている
• その他、たくさんの機能

Pinot MCPの動作例

以下はPinot MCPの動作例です。

メタデータの取得

データの取得と分析

プロンプト: GitHubイベントを時間軸でヒストグラムにできますか？

サンプルプロンプト

Claudeが起動したら、ハンマー🛠️アイコンをクリックして、これらのプロンプトを試してみてください。

• Pinotのデータを分析してくれますか？Pinotツールを使って、テーブルのリストを見て始めてください。
• GitHubイベントを時間軸でヒストグラムにできますか？

クイックスタート

前提条件

uvのインストール（未インストールの場合）

uvは、Rustで書かれた高速なPythonパッケージインストーラーとリゾルバーです。pipの代わりに使用でき、パフォーマンスが大幅に向上します。

curl -LsSf https://astral.sh/uv/install.sh | sh

# bashrc/zshrcを再読み込みして変更を有効にする。または、ターミナルを再起動する
# source ~/.bashrc

インストール

# リポジトリをクローンする
git clone git@github.com:startreedata/mcp-pinot.git
cd mcp-pinot
uv pip install -e . # 依存関係をインストールする

# 開発用の依存関係（テストツールを含む）をインストールする場合は、以下を使用する
# uv pip install -e .[dev] 

Pinotクラスターの設定

MCPサーバーは、ルートディレクトリにuvicorn設定スタイルの.envファイルが必要です。このリポジトリには、Pinotのクイックスタート設定を想定したサンプルの.env.exampleファイルが含まれています。

mv .env.example .env

サーバーの起動

uv --directory . run mcp_pinot/server.py

サーバーが起動し、STDIOで待機していることを示すログが表示されるはずです。

Pinotクイックスタートの起動（オプション）

Dockerを使用してPinot QuickStartを起動します。

docker run --name pinot-quickstart -p 2123:2123 -p 9000:9000 -p 8000:8000 -d apachepinot/pinot:latest QuickStart -type batch

MCPサーバーにクエリを送信する

uv --directory . run tests/test_service/test_pinot_quickstart.py

このクイックスタートでは、すべてのツールをチェックし、airlineStatsテーブルにクエリを送信します。

Claude Desktopとの統合

Claudeの設定ファイルを開く

vi ~/Library/Application\ Support/Claude/claude_desktop_config.json

MCPサーバーのエントリを追加する

{
  "mcpServers": {
      "pinot_mcp_claude": {
          "command": "/path/to/uv",
          "args": [
              "--directory",
              "/path/to/mcp-pinot-repo",
              "run",
              "mcp_pinot/server.py"
          ],
          "env": {
            // .env設定をここに含めることもできます
          }
      }
  }
}

/path/to/uvをuvコマンドの絶対パスに置き換えてください。which uvを実行するとわかります。 /path/to/mcp-pinotをこのリポジトリをクローンしたフォルダの絶対パスに置き換えてください。 複数のPinotクラスターをMCPサーバーとして接続したい場合は、.envファイルの代わりにここで環境変数を設定することもできます。

Claude Desktopを再起動する

Claudeは起動時に自動的にMCPサーバーを起動し、新しいPinotベースのツールを認識します。

開発者向け

• すべてのツールはutils/pinot_client.pyのPinotクラスで定義されています。

ビルド

以下のコマンドでプロジェクトをビルドします。

pip install -e ".[dev]"

テスト

以下のコマンドでリポジトリをテストします。

pytest

Dockerイメージのビルド

docker build -t mcp-pinot .

コンテナの実行

docker run -v $(pwd)/.env:/app/.env mcp-pinot

注: コンテナを実行する前に、.envファイルに適切なPinotクラスター設定を構成してください。