Сервер BigQuery MCP

Что это? 🤔

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

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

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

Related MCP server: MemGPT MCP Server

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

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