Gemini Cloud Assist MCP Server

resmi

Gemini Cloud Assist API'lerine bağlanan ve Google Cloud ortamınızı doğal dil kullanarak yönetmenizi ve sorun gidermenizi sağlayan bir MCP Sunucusu.

GitHub

Dokümantasyon

Gemini Cloud Assist MCP sunucusu

[!IMPORTANT] Özel Önizleme Bildirimi Gemini Cloud Assist MCP sunucu API'leri şu anda Özel Önizleme aşamasındadır ve bir izin listesinin arkasındadır. Erişim talep etmek için lütfen Google Cloud hesap ekibinizle iletişime geçin.

[!WARNING] Kullanımdan Kaldırma Bildirimi ve Uzak MCP Sunucusuna Geçiş

Gemini Cloud Assist MCP sunucusu, yerel Node.js mimarisinden Uzak MCP Sunucusu mimarisine geçiş yapmıştır. Eski yerel Node.js sunucusu önümüzdeki aylarda desteğini kaybedecektir.

Yeni Uzak MCP Sunucularını kullanmak için lütfen v0.8.0 veya daha yeni bir sürüm kullanın. Geçiş sırasında eski yerel sunucuyu kullanmaya devam etmek isterseniz, lütfen yapılandırmanızı eski sürümlere sabitleyin.

Bu sunucu, Gemini CLI gibi Model Bağlam Protokolü (MCP) istemcilerini Gemini Cloud Assist API'lerine bağlar. Google Cloud ortamınızı doğrudan yerel komut satırından anlamak, yönetmek ve sorun gidermek için doğal dil kullanmanıza olanak tanır.

[!NOTE] Google Cloud Platform Hizmet Şartları (https://cloud.google.com/terms/ adresinde mevcuttur) ve Veri İşleme ve Güvenlik Şartları (https://cloud.google.com/terms/data-processing-terms adresinde mevcuttur), Gemini Cloud Assist MCP Sunucusu yazılımının hiçbir bileşeni için geçerli değildir.

Gemini Cloud Assist hakkında daha fazla bilgi edinmek için Google Cloud belgelerindeki Gemini Cloud Assist'e genel bakış sayfasına bakın.

✨ Temel özellikler

Altyapı tasarlama: Google Cloud için altyapı yapılandırmaları oluşturun ve mimarisini tasarlayın.
Sorun giderme: Google Cloud ortamınızdaki karmaşık sorunların kök nedenini bulmak için derinlemesine araştırmalar yürütün.
Kaynakları yönetme: Doğrudan sohbet iş akışınızdan Google Cloud kaynakları oluşturun, güncelleyin ve silin (Aracı Eylemleri gerektirir).
Maliyetleri optimize etme: Harcamalarınızı analiz edin, maliyetleri takip edin ve atıl kaynaklar gibi verimlilik fırsatlarını belirleyin.
Genel yardım alma: Google Cloud en iyi uygulamaları, mimarileri ve operasyonları hakkında sorular sorun ve rehberlik alın.

Hızlı başlangıç

Başlamadan önce aşağıdakilerin kurulu olduğundan emin olun:

Google Cloud SDK kurulu ve yapılandırılmış.
Bir Google Cloud projesi.
Kullanıcı hesabınızda aşağıdaki IAM rolleri:
- roles/serviceusage.serviceUsageAdmin: Cloud Assist API'lerini etkinleştirmek için gereklidir.
- roles/geminicloudassist.user: Cloud Assist API'lerine istekte bulunmak için gereklidir.

Adım 1: Google Cloud'da kimlik doğrulama

Gemini Cloud Assist MCP sunucusu, Google Cloud'da güvenli kimlik doğrulaması yapmak için yerel Uygulama Varsayılan Kimlik Bilgilerini (ADC) kullanır. ADC'yi ayarlamak için aşağıdaki gcloud komutlarını çalıştırın:

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

MCP istemcinizi yapılandırma

İstemci-aracı yapılandırması, hangi aracıyı kullandığınıza bağlıdır.

Gemini CLI

MCP sunucusunu bir Gemini CLI uzantısı olarak yükleyin:

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

Alternatif olarak, yapılandırmayı ~/.gemini/settings.json dosyanıza manuel olarak ekleyebilirsiniz:

"mcpServers": {
  "gemini_cloud_assist": {
    "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  },
  "application_design_center": {
    "httpUrl": "https://designcenter.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  }
}

Antigravity

Aşağıdakini mcp_config.json dosyanıza ekleyin:

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  },
  "application_design_center": {
    "serverUrl": "https://designcenter.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  }
}

Cursor

Google Cloud projenizde bir masaüstü uygulaması için OAuth 2.0 istemci kimliği oluşturun.
URI://anysphere.cursor-mcp/oauth/callback adresini yönlendirme URL'si olarak yapılandırın.
Aşağıdaki yapılandırma bloğunu ekleyin veya birleştirin:

{
  "mcpServers": {
    "gemini_cloud_assist": {
      "url": "https://geminicloudassist.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

Özel uygulamanız için yapılandırma talimatlarını izleyin:

Claude.ai

MCP Araçları

Gemini Cloud Assist MCP araçları

Gemini Cloud Assist, bir dizi MCP aracı aracılığıyla erişilebilen bir aracıdır. MCP araç çağrıları tarafından çağrılan aracı, Google Cloud'a dahili olarak kendi araç çağrılarını yapar. Aracıların tüketmesi için aşağıdaki MCP araçları yayınlanmıştır:

Araç	Açıklama
`ask_cloud_assist`	Google Cloud yardımı ve Gemini Cloud Assist aracısı için birincil arayüz. Tüm işlevlere bu araç aracılığıyla erişilebilir.
`design_infra`	Google Cloud'da altyapı tasarlama ve mimari oluşturma iş akışlarını destekler.
`investigate_issue`	Google Cloud'da sorun giderme iş akışlarını destekler. Bir Araştırma kaynağı aracılığıyla hızlı sorun giderme veya daha derin sorun giderme yapabilir.
`invoke_operation`	Google Cloud'da kaynak oluşturma, güncelleme ve silme iş akışlarını destekler. Yalnızca Aracı Eylemleri etkinleştirildiğinde çalışır.
`optimize_costs`	Google Cloud maliyetlerini analiz etme, takip etme ve optimize etme iş akışlarını destekler. Harcama dökümleri sağlar ve maliyet verimliliği fırsatlarını belirler.

Uygulama Tasarım Merkezi MCP araçları

Genellikle GCA'nın design_infra aracı tarafından düzenlenen Uygulama Tasarım Merkezi MCP araçları, şablon yönetimi, güvenlik uyumluluğu ve düzeltme ile dağıtım dahil olmak üzere Uygulama Tasarım Merkezi'ni kullanarak altyapı uygulama yaşam döngüsünü yönetir.

Araç	Açıklama
`setup_adc`	Uygulama Tasarım Merkezi ortamını başlatır. Bu, diğer ADC araçları kullanılmadan önce gerçekleştirilmesi gereken tek seferlik bir kurulum adımıdır.
`manage_application`	Bir uygulamanın dağıtım yaşam döngüsünü yönetir. Uygulama Tasarım Merkezi'ni kullanarak doğrulanmış bir tasarımı dağıtmak veya mevcut bir dağıtımın durumunu ve ayrıntılarını almak için bu aracı kullanın. Bu, tasarımınızı Google Cloud'da dağıtılmış bir altyapıya dönüştüren son adımdır.
`manage_application_template`	Altyapı tasarımınızın Kod Olarak Altyapı (IaC) içeriğini yönetir. Tasarımı bir Uygulama Tasarım Merkezi şablonu olarak kaydetmek, tasarımı Terraform dosyaları olarak dışa aktarmak veya tasarımı güncellemek (ör. bileşen, parametre yapılandırmaları vb.) için bunu kullanın.
`assess_best_practices`	Dağıtımdan önce uygulama tasarımınız üzerinde kapsamlı bir güvenlik ve yapılandırma denetimi gerçekleştirir. Tasarımı Security Command Center çerçevelerine ve ilgili kontrollere göre doğrular, düzeltme için eyleme dönüştürülebilir bulgular içeren bir rapor döndürür.
`list_application_templates`	Mevcut tüm uygulama tasarımlarını listeler.

Not: Bu araçlar kararlı API'ler olarak değerlendirilmemelidir. Gemini Cloud Assist'in gelişen yeteneklerine uyum sağlamak için parametreler yeniden adlandırılabilir veya değiştirilebilir.

Aracı Becerileri

Gemini Cloud Assist MCP araçları, aracınıza araçların nasıl düzgün kullanılacağını öğretmek için SKILL.md dosyalarını kullanır. Beceriler, aracınızı birden fazla aracı bir iş akışında zincirleme, ilgili yerel bilgileri Gemini Cloud Assist'e aktarma ve açık çağrıyı etkinleştirme konusunda yönlendirmeye yardımcı olur.

Beceri	Açıklama
`designing-and-deploying-infrastructure`	Uygulama Tasarım Merkezi (ADC) ve Gemini Cloud Assist araçlarını kullanarak bulut altyapısının nasıl tasarlanacağı, değerlendirileceği, dağıtılacağı ve sorun giderileceği konusunda aracıya rehberlik eder.
`operating-google-cloud`	Özel MCP araçlarını kullanarak Google Cloud Platform (GCP) kaynaklarını ve Kubernetes'i yönetmek için talimatlar sağlar.

Katkıda Bulunma

Bir hata ile karşılaşırsanız, lütfen GitHub Sorunları sayfamızda bir sorun bildirin.
Bir çekme isteği göndermeden önce lütfen Katkıda Bulunma Kılavuzumuzu inceleyin.

Lisans

Bu proje Apache 2.0 Lisansı altında lisanslanmıştır ve herhangi bir kullanım veya amaç için garanti veya taahhüt olmaksızın olduğu gibi sağlanmaktadır. Ayrıntılar için LICENSE dosyasına bakın.