Apache Pinot MCP Server — MCP-сервер для Claude Code: установка
Подключает Claude Code к Apache Pinot: агент сможет читать данные и метаданные, а также подготовить изменения схемы или конфигурации к проверке.
claude mcp add --env PINOT_CONTROLLER_URL=<PINOT_CONTROLLER_URL> --env PINOT_BROKER_URL=<PINOT_BROKER_URL> --env PINOT_USERNAME=<PINOT_USERNAME> --env PINOT_PASSWORD=<PINOT_PASSWORD> --env PINOT_TOKEN=<PINOT_TOKEN> --transport stdio apache-pinot-mcp-server -- uvx mcp-pinot-serverЧто делает Apache Pinot MCP Server
Сервер на Python связывает Apache Pinot с агентом через MCP. Он умеет проверять соединение, просматривать таблицы, схемы, сегменты и индексы, а также выполнять запросы только для чтения. Большие ответы выдаются страницами, чтобы не загружать в контекст весь результат сразу.
Изменение схемы, конфигурации таблицы или фильтров сначала нужно запросить в режиме dry_run=true. Сервер возвращает предварительный просмотр и одноразовый токен подтверждения; применить изменение можно после согласования с пользователем. Предварительная проверка не гарантирует, что Pinot примет запись.
Для подключения нужны адреса контроллера и брокера Pinot, а также параметры учётных данных. Например, Claude Code можно настроить командой claude mcp add mcp-pinot -e PINOT_PASSWORD=<PINOT_PASSWORD> -e PINOT_TOKEN=<PINOT_TOKEN> -- uvx mcp-pinot-server; без адресов кластера серверу не к чему подключаться.
Какие задачи решает
- проверить соединение с брокером и контроллером Pinot
- посмотреть схемы и конфигурацию таблиц
- выполнить SQL-запрос только для чтения
- получить метаданные сегментов и индексов
- предварительно проверить изменение схемы или таблицы
Примеры запросов агенту
- Покажи таблицы и схему таблицы
eventsв Pinot. - Выполни запрос только для чтения: посчитай записи по сервисам в таблице
events. - Подготовь изменение конфигурации таблицы в режиме предварительного просмотра и покажи, что изменится.
Как установить Apache Pinot MCP Server
Командой платформы
claude mcp add --env PINOT_CONTROLLER_URL=<PINOT_CONTROLLER_URL> --env PINOT_BROKER_URL=<PINOT_BROKER_URL> --env PINOT_USERNAME=<PINOT_USERNAME> --env PINOT_PASSWORD=<PINOT_PASSWORD> --env PINOT_TOKEN=<PINOT_TOKEN> --transport stdio apache-pinot-mcp-server -- uvx mcp-pinot-serverВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-pinot-server <команда>
Командой платформы
codex mcp add apache-pinot-mcp-server --env PINOT_CONTROLLER_URL=<PINOT_CONTROLLER_URL> --env PINOT_BROKER_URL=<PINOT_BROKER_URL> --env PINOT_USERNAME=<PINOT_USERNAME> --env PINOT_PASSWORD=<PINOT_PASSWORD> --env PINOT_TOKEN=<PINOT_TOKEN> -- uvx mcp-pinot-serverВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-pinot-server <команда>
Файл настроек
{
"mcpServers": {
"apache-pinot-mcp-server": {
"command": "uvx",
"args": [
"mcp-pinot-server"
],
"env": {
"PINOT_CONTROLLER_URL": "<PINOT_CONTROLLER_URL>",
"PINOT_BROKER_URL": "<PINOT_BROKER_URL>",
"PINOT_USERNAME": "<PINOT_USERNAME>",
"PINOT_PASSWORD": "<PINOT_PASSWORD>",
"PINOT_TOKEN": "<PINOT_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-pinot-server <команда>
Файл настроек
{
"servers": {
"apache-pinot-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-pinot-server"
],
"env": {
"PINOT_CONTROLLER_URL": "<PINOT_CONTROLLER_URL>",
"PINOT_BROKER_URL": "<PINOT_BROKER_URL>",
"PINOT_USERNAME": "<PINOT_USERNAME>",
"PINOT_PASSWORD": "<PINOT_PASSWORD>",
"PINOT_TOKEN": "<PINOT_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-pinot-server <команда>
Командой платформы
gemini mcp add -e PINOT_CONTROLLER_URL=<PINOT_CONTROLLER_URL> -e PINOT_BROKER_URL=<PINOT_BROKER_URL> -e PINOT_USERNAME=<PINOT_USERNAME> -e PINOT_PASSWORD=<PINOT_PASSWORD> -e PINOT_TOKEN=<PINOT_TOKEN> apache-pinot-mcp-server uvx mcp-pinot-serverВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-pinot-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apache Pinot MCP Server
Как установить Apache Pinot MCP Server в Claude Code?
Выполните claude mcp add mcp-pinot -e PINOT_PASSWORD=<PINOT_PASSWORD> -e PINOT_TOKEN=<PINOT_TOKEN> -- uvx mcp-pinot-server. Для этого способа задайте значения для пароля и токена Pinot.
Что делает Apache Pinot MCP Server?
Он подключает агента к Apache Pinot для чтения SQL-данных и просмотра метаданных таблиц, схем, сегментов и индексов. Также сервер позволяет подготовить изменения конфигурации к подтверждению.
Как сервер защищает изменения в Pinot?
Перед изменением нужно вызвать соответствующий инструмент с dry_run=true и показать предварительный просмотр пользователю. Для применения требуются подтверждение и одноразовый confirmation_token из этого просмотра.
