BigQuery MCP Server

Сервер BigQuery MCP

Что это? 🤔

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

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

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

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

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

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

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

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

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

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

Предпосылки

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

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

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

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

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

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

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

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

1. Аутентификация с помощью 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
2. Добавьте в конфигурацию 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" ] } } }
3. Начните общаться! Откройте Claude Desktop и начните задавать вопросы о своих данных.

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

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

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

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

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

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

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

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

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

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

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

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

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

• 🐛 Сообщить о проблемах
• 💡 Запросы функций
• 📖 Документация

Лицензия 📝

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

Автор ✍️

Салих Эргют

Спонсорство

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

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

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