GCP MCP

GCP MCP

Сервер Model Context Protocol (MCP), который позволяет помощникам ИИ, таким как Claude, взаимодействовать с вашей средой Google Cloud Platform. Это позволяет выполнять запросы на естественном языке и управлять вашими ресурсами GCP во время разговоров.

Функции

• 🔍 Запрашивайте и изменяйте ресурсы GCP, используя естественный язык
• ☁️ Поддержка нескольких проектов GCP
• 🌐 Поддержка нескольких регионов
• 🔐 Безопасная обработка учетных данных (никакие учетные данные не передаются внешним службам)
• 🏃‍♂️ Локальное выполнение с вашими учетными данными GCP
• 🔄 Автоматические повторные попытки для повышения надежности

Предпосылки

• Node.js
• Клод Рабочий стол/Курсор/Виндсерфинг
• Учетные данные GCP настроены локально (учетные данные приложения по умолчанию)

Установка

1. Клонируйте репозиторий:

2. Установить зависимости:

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

Клод Десктоп

1. Откройте приложение Claude для ПК и перейдите в Настройки -> Разработчик -> Изменить конфигурацию.
2. Добавьте следующую запись в ваш claude_desktop_config.json :

через npm:

Если вы установили из исходного кода:

Замените /path/to/gcp-mcp на фактический путь к каталогу вашего проекта, если вы используете установку из исходного кода.

Курсор

1. Откройте Курсор и перейдите в Настройки (⌘,)
2. Перейдите в раздел AI -> Model Context Protocol.
3. Добавьте новую конфигурацию MCP:

Виндсерфинг

1. Откройте ~/.windsurf/config.json (создайте, если его нет)
2. Добавьте конфигурацию MCP:

Настройка GCP

1. Настройте учетные данные GCP:
   • Настройте учетные данные приложения по умолчанию с помощью gcloud auth application-default login
2. Обновите своего помощника на основе искусственного интеллекта (Claude Desktop/Cursor/Windsurf)

Использование

Начните с выбора проекта или задайте такие вопросы, как:

• «Список всех проектов GCP, к которым у меня есть доступ»
• «Покажите мне все экземпляры Cloud SQL в проекте X»
• «Каков мой текущий платежный статус?»
• «Покажите мне журналы моих сервисов Cloud Run»
• «Список всех кластеров GKE в us-central1»
• «Покажите мне все контейнеры Cloud Storage в проекте X»
• «Какие облачные функции развернуты в us-central1?»
• «Список всех служб Cloud Run»
• «Покажите мне наборы данных и таблицы BigQuery»

Доступные инструменты

1. run-gcp-code : выполнение вызовов API GCP с использованием кода TypeScript
2. list-projects : Список всех доступных проектов GCP
3. select-project : выбор проекта GCP для последующих операций
4. get-billing-info : Получить платежную информацию для текущего проекта
5. get-cost-forecast : Получить прогноз стоимости для текущего проекта
6. get-billing-budget : Получить бюджеты выставления счетов для текущего проекта
7. list-gke-clusters : Список всех кластеров GKE в текущем проекте
8. list-sql-instances : список всех экземпляров Cloud SQL в текущем проекте
9. get-logs : Получить записи облачного журнала для текущего проекта

Примеры взаимодействий

1. Список доступных проектов:

2. Выберите проект:

3. Проверьте статус платежа:

4. Просмотр журналов:

Поддерживаемые услуги

• Google Compute Engine
• Облачное хранилище
• Облачные функции
• Облачный забег
• BigQuery
• Облачный SQL
• Google Kubernetes Engine (GKE)
• Ведение журнала в облаке
• Облачный биллинг
• Менеджер ресурсов
• Скоро будет больше...

Поиск неисправностей

Чтобы просмотреть журналы:

Распространенные проблемы:

1. Ошибки аутентификации: убедитесь, что вы запустили gcloud auth application-default login
2. Ошибки разрешений: проверьте роли IAM для вашей учетной записи
3. Ошибки API: убедитесь, что в вашем проекте включены требуемые API.

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Лицензия

Массачусетский технологический институт