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 с правами ваших учётных данных без указанных ограничений на тип запроса; запросы тарифицируются.
Настройка клиентов
{
"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.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.