Сервер BigQuery MCP

значок кузнеца

Что это? 🤔

Это сервер, который позволяет вашим LLM (например, Клоду) напрямую общаться с вашими данными BigQuery! Думайте об этом как о дружелюбном переводчике, который находится между вашим помощником AI и вашей базой данных, гарантируя, что они могут общаться безопасно и эффективно.

Быстрый пример

You: "What were our top 10 customers last month?" Claude: *queries your BigQuery database and gives you the answer in plain English*

Больше не нужно писать SQL-запросы вручную — просто работайте со своими данными в естественной обстановке!

Как это работает? 🛠️

Этот сервер использует протокол Model Context Protocol (MCP), который является универсальным переводчиком для связи между ИИ и базой данных. Хотя MCP предназначен для работы с любой моделью ИИ, сейчас он доступен в качестве предварительной версии для разработчиков в Claude Desktop.

Вот все, что вам нужно сделать:

Настройте аутентификацию (см. ниже)
Добавьте данные вашего проекта в файл конфигурации Claude Desktop
Начните работать с данными BigQuery естественным образом!

Что он может делать? 📊

Выполняйте SQL-запросы, просто задавая вопросы на простом английском языке
Доступ к таблицам и материализованным представлениям в ваших наборах данных
Изучите схемы наборов данных с четкой маркировкой типов ресурсов (таблицы и представления)
Анализируйте данные в безопасных пределах (лимит запроса 1 ГБ по умолчанию)
Сохраните свои данные в безопасности (доступ только для чтения)

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

Предпосылки

Node.js 14 или выше
Проект Google Cloud с включенным BigQuery
Либо установлен Google Cloud CLI, либо файл ключа учетной записи службы
Claude Desktop (в настоящее время единственный поддерживаемый интерфейс LLM)

Вариант 1: Быстрая установка с помощью Smithery (рекомендуется)

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

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

Установщик запросит у вас:

Ваш идентификатор проекта Google Cloud
Местоположение BigQuery (по умолчанию us-central1)

После настройки Smithery автоматически обновит конфигурацию Claude Desktop и перезапустит приложение.

Вариант 2: Ручная настройка

Если вы предпочитаете ручную настройку или вам нужен больший контроль:

Аутентификация с помощью Google Cloud (выберите один способ):
- Использование Google Cloud CLI (отлично подходит для разработки):
  gcloud auth application-default login
- Использование учетной записи службы (рекомендуется для производства):
  # Save your service account key file and use --key-file parameter # Remember to keep your service account key file secure and never commit it to version control
Добавьте в конфигурацию Claude Desktop Добавьте это в ваш claude_desktop_config.json :
- Базовая конфигурация:
  { "mcpServers": { "bigquery": { "command": "npx", "args": [ "-y", "@ergut/mcp-bigquery-server", "--project-id", "your-project-id", "--location", "us-central1" ] } } }
- С учетной записью службы:
  { "mcpServers": { "bigquery": { "command": "npx", "args": [ "-y", "@ergut/mcp-bigquery-server", "--project-id", "your-project-id", "--location", "us-central1", "--key-file", "/path/to/service-account-key.json" ] } } }
Начните общаться! Откройте Claude Desktop и начните задавать вопросы о своих данных.

Аргументы командной строки

Сервер принимает следующие аргументы:

--project-id : (обязательно) Ваш идентификатор проекта Google Cloud
--location : (Необязательно) местоположение BigQuery, по умолчанию «us-central1»
--key-file : (Необязательно) Путь к файлу JSON ключа учетной записи службы

Пример использования учетной записи службы:

npx @ergut/mcp-bigquery-server --project-id your-project-id --location europe-west1 --key-file /path/to/key.json

Требуются разрешения

Вам понадобится что-то из этого:

roles/bigquery.user (рекомендуется)
ИЛИ оба варианта:
- roles/bigquery.dataViewer
- roles/bigquery.jobUser

Настройка разработчика (необязательно) 🔧

Хотите настроить или внести свой вклад? Вот как это сделать локально:

# Clone and install git clone https://github.com/ergut/mcp-bigquery-server cd mcp-bigquery-server npm install # Build npm run build

Затем обновите конфигурацию Claude Desktop, чтобы она указывала на вашу локальную сборку:

{ "mcpServers": { "bigquery": { "command": "node", "args": [ "/path/to/your/clone/mcp-bigquery-server/dist/index.js", "--project-id", "your-project-id", "--location", "us-central1", "--key-file", "/path/to/service-account-key.json" ] } } }

Текущие ограничения ⚠️

Поддержка MCP в настоящее время доступна только в Claude Desktop (предварительная версия для разработчиков)
Подключения ограничены локальными серверами MCP, работающими на той же машине.
Запросы доступны только для чтения с ограничением обработки в 1 ГБ.
Хотя поддерживаются как таблицы, так и представления, некоторые сложные типы представлений могут иметь ограничения.

Поддержка и ресурсы 💬

Лицензия 📝

Лицензия MIT. Подробную информацию см. в файле LICENSE .

Автор ✍️

Салих Эргют

Спонсорство

Этот проект с гордостью спонсируется:

История версий 📋

Обновления и историю версий смотрите на сайте CHANGELOG.md .

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.