Сервер 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-запросы вручную — просто работайте со своими данными в естественной обстановке!

Related MCP server: MemGPT MCP Server

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

Этот сервер использует протокол 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 .

BigQuery MCP Server