MCP-сервер BigQuery

Сервер Model Context Protocol, который обеспечивает доступ к BigQuery. Этот сервер позволяет LLM проверять схемы баз данных и выполнять запросы.

Компоненты

Инструменты

На сервере реализован один инструмент:

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

Конфигурация

Сервер можно настроить с помощью аргументов командной строки или переменных среды.

Аргумент	Переменная среды	Необходимый	Описание
`--project`	`BIGQUERY_PROJECT`	Да	Идентификатор проекта GCP.
`--location`	`BIGQUERY_LOCATION`	Да	Местоположение GCP (например `europe-west9` ).
`--dataset`	`BIGQUERY_DATASETS`	Нет	Принимать во внимание только определенные наборы данных BigQuery. Несколько наборов данных можно указать, повторив аргумент (например, `--dataset my_dataset_1 --dataset my_dataset_2` ) или объединив их запятой в переменной окружения (например, `BIGQUERY_DATASETS=my_dataset_1,my_dataset_2` ). Если не указано иное, будут рассмотрены все наборы данных в проекте.
`--key-file`	`BIGQUERY_KEY_FILE`	Нет	Путь к файлу ключа учетной записи службы для BigQuery. Если не указан, сервер будет использовать учетные данные по умолчанию.

Быстрый старт

Установить

Установка через Smithery

Чтобы автоматически установить BigQuery Server для Claude Desktop через Smithery :

npx -y @smithery/cli install mcp-server-bigquery --client claude

Клод Десктоп

В MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json В Windows: %APPDATA%/Claude/claude_desktop_config.json

Конфигурация серверов разработки/неопубликованных

"mcpServers": {
  "bigquery": {
    "command": "uv",
    "args": [
      "--directory",
      "{{PATH_TO_REPO}}",
      "run",
      "mcp-server-bigquery",
      "--project",
      "{{GCP_PROJECT_ID}}",
      "--location",
      "{{GCP_LOCATION}}"
    ]
  }
}

Конфигурация опубликованных серверов

"mcpServers": {
  "bigquery": {
    "command": "uvx",
    "args": [
      "mcp-server-bigquery",
      "--project",
      "{{GCP_PROJECT_ID}}",
      "--location",
      "{{GCP_LOCATION}}"
    ]
  }
}

Замените {{PATH_TO_REPO}} , {{GCP_PROJECT_ID}} и {{GCP_LOCATION}} соответствующими значениями.

Разработка

Строительство и издательское дело

Чтобы подготовить пакет к распространению:

Увеличьте номер версии в pyproject.toml
Синхронизируем зависимости и обновляем файл блокировки:

uv sync

Сборка дистрибутивов пакетов:

uv build

Это создаст исходный код и дистрибутивы wheel в каталоге dist/ .

Опубликовать в PyPI:

uv publish

Примечание: вам необходимо задать учетные данные PyPI с помощью переменных среды или флагов команд:

Токен: --token или UV_PUBLISH_TOKEN
Или имя пользователя/пароль: --username / UV_PUBLISH_USERNAME и --password / UV_PUBLISH_PASSWORD

Отладка

Поскольку серверы MCP работают через stdio, отладка может быть сложной. Для лучшего опыта отладки мы настоятельно рекомендуем использовать MCP Inspector .

Вы можете запустить MCP Inspector через npm с помощью этой команды:

npx @modelcontextprotocol/inspector uv --directory {{PATH_TO_REPO}} run mcp-server-bigquery

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Related MCP Servers

MongoDB
kiliczsh
A
security
A
license
A
quality
A Model Context Protocol server that provides access to MongoDB databases. This server enables LLMs to inspect collection schemas and execute read-only queries.
Last updated -
8
885
191
TypeScript
MIT License
MCP Salesforce Connector
smn2gnt
A
security
A
license
A
quality
A Model Context Protocol server that enables LLMs to interact with Salesforce data through SOQL queries, SOSL searches, and various API operations including record management.
Last updated -
10
53
Python
MIT License
BigQuery MCP Server
takuya0206
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to understand BigQuery dataset structures and execute SQL queries.
Last updated -
TypeScript
MIT License
Enhanced PostgreSQL MCP Server
GarethCott
-
security
F
license
-
quality
A Model Context Protocol server providing both read and write access to PostgreSQL databases, enabling LLMs to query data, modify records, and manage database schemas.
Last updated -
4
JavaScript

View all related MCP servers

BigQuery MCP server