mcp-server-bigquery

mcp-server-bigquery — MCP-сервер сообщества (автор — LucasHild). BigQuery: просмотр схемы и запросы. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
LucasHild
Лицензия
MIT
Транспорт
stdio
Авторизация
other
ОС
Не указана
Языки
python

Уровень риска: high

Выполняет SQL-запросы в BigQuery с правами ваших учётных данных без указанных ограничений на тип запроса; запросы тарифицируются.

Настройка клиентов

codex
{
    "code": "codex mcp add bigquery -- uvx mcp-server-bigquery --project {{GCP_PROJECT_ID}} --location {{GCP_LOCATION}}",
    "lang": "bash",
    "notes": "Подставьте проект и регион",
    "verified": "docs"
}

Что умеет

mcp-server-bigquery — MCP-сервер, который даёт языковым моделям доступ к Google BigQuery: модель изучает схемы данных и выполняет запросы. Это удобный способ задавать вопросы к хранилищу данных на естественном языке: ассистент сам находит нужные таблицы, смотрит их структуру, пишет SQL в диалекте BigQuery и возвращает результат.

Сервер реализует три инструмента:

  • execute-query — выполняет SQL-запрос в диалекте BigQuery;
  • list-tables — показывает все таблицы в базе BigQuery;
  • describe-table — описывает схему конкретной таблицы.

Типичный порядок работы ассистента: сначала list-tables, чтобы понять, какие данные есть, затем describe-table для нужных таблиц и в конце execute-query с готовым запросом.

Настройка задаётся аргументами командной строки или переменными окружения:

  • --project / BIGQUERY_PROJECT — идентификатор проекта GCP (обязательно);
  • --location / BIGQUERY_LOCATION — регион GCP, например europe-west9 (обязательно);
  • --dataset / BIGQUERY_DATASETS — учитывать только указанные наборы данных; аргумент можно повторять, а в переменной перечислять через запятую. Без него рассматриваются все наборы проекта;
  • --key-file / BIGQUERY_KEY_FILE — путь к ключу сервисного аккаунта; без него используются учётные данные по умолчанию;
  • --timeout / BIGQUERY_TIMEOUT — максимальное время ожидания запроса в секундах; без него запрос ждёт сколько угодно.

Кому подойдёт

  • Аналитикам данных, которые хотят быстро получать ответы из BigQuery без ручного написания SQL.
  • Инженерам данных, изучающим незнакомые наборы данных и схемы таблиц.
  • Продуктовым командам, которым нужны выборки и отчёты прямо в диалоге с ассистентом.

Похожие серверы — в категории базы данных.

Установка

Нужен uv: сервер запускается через uvx mcp-server-bigquery с обязательными параметрами проекта и региона. Для доступа используются учётные данные Google Cloud по умолчанию либо ключ сервисного аккаунта, переданный через --key-file. Чтобы ограничить область работы, перечислите нужные наборы данных через --dataset.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add bigquery --scope user -- uvx mcp-server-bigquery --project {{GCP_PROJECT_ID}} --location {{GCP_LOCATION}}

Замените заглушки {{GCP_PROJECT_ID}} и {{GCP_LOCATION}} на идентификатор проекта и регион. Дополнительные параметры (--dataset, --key-file, --timeout) добавляются в конец команды.

Проверка

Спросите ассистента: «Какие таблицы есть в BigQuery?» — должен сработать list-tables.

Примеры задач

Покажи схему таблицы events и посчитай число уникальных пользователей по дням за последнюю неделю.
Найди десять самых продаваемых товаров в наборе данных sales за прошлый месяц.

Риски

  • Запросы к облачным данным. execute-query выполняет SQL с правами ваших учётных данных; README не указывает ограничений на тип запроса, поэтому используйте сервисный аккаунт только с правами на чтение, если изменения данных не нужны.
  • Стоимость. Запросы BigQuery тарифицируются по объёму обработанных данных; задайте --timeout и ограничьте наборы данных через --dataset.
  • Ключ сервисного аккаунта храните в защищённом месте и не публикуйте.

Частые вопросы

Как ограничить доступ к данным?

Перечислите нужные наборы через --dataset и используйте сервисный аккаунт с минимальными правами.

Нужен ли ключ сервисного аккаунта?

Нет, без --key-file сервер использует учётные данные Google Cloud по умолчанию.

Можно ли ограничить время запроса?

Да, параметром --timeout или переменной BIGQUERY_TIMEOUT.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

dbx

Запросы агентов к базам данных через подключения, настроенные в DBX.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники