Google Cloud MCP

gcloud MCP Sunucusu ☁️

gcloud Model Context Protocol (MCP) sunucusu, yapay zeka asistanlarının gcloud CLI kullanarak Google Cloud ortamıyla kolayca etkileşim kurmasını sağlar. gcloud MCP sunucusu ile şunları yapabilirsiniz:

• Doğal dil kullanarak Google Cloud ile etkileşim kurun. Karmaşık komut sözdizimini, bayrakları ve argümanları ezberlemek yerine istediğiniz sonucu tanımlayın.
• Karmaşık iş akışlarını otomatikleştirin ve basitleştirin. Birden fazla bulut işlemini tek, tekrarlanabilir bir komutta zincirleyerek manuel çabayı ve hata olasılığını azaltın.
• Bulut yönetimine giriş engelini düşürün. gcloud'a daha az aşina olan ekip üyelerinin güçlü eylemleri güvenle ve emniyetle gerçekleştirmesini sağlayın.

📡 Mevcut MCP Sunucuları

Bu depo, gcloud MCP sunucusuna ek olarak başka MCP sunucularını da barındırır. Güncel bir liste aşağıdadır ve bu depo dışında barındırılan diğer Google Cloud MCP sunucularına bağlantılar burada bulunur.

MCP Sunucu Adı	Açıklama	Paket Adı	Sürüm
gcloud	Doğal dil komutları kullanarak gcloud CLI aracılığıyla Google Cloud ile etkileşim kurun.	gcloud-mcp
observability	Günlükleri, metrikleri ve izleri sorgulamak için Google Cloud Observability API'lerine erişin.	observability-mcp
storage	Paket ve nesne yönetimi için Google Cloud Storage ile etkileşim kurun.	storage-mcp
backupdr	Google Cloud Backup and Disaster Recovery ile etkileşim kurun.	backupdr-mcp

🚀 Başlarken

Ön Koşullar

• Node.js: sürüm 20 veya üzeri
• gcloud CLI

✨ MCP sunucunuzu kurun

Gemini CLI ve Gemini Code Assist

MCP sunucularını Gemini CLI veya Gemini Code Assist ile entegre etmek için, tabloda listelenen MCP sunucusu için ana dizininizden aşağıdaki kurulum komutunu çalıştırın. Bu, MCP sunucusunu mevcut kullanıcı için bir Gemini CLI uzantısı olarak yükleyecek ve tüm projeleriniz için kullanılabilir hale getirecektir.

npx @google-cloud/[PACKAGE_NAME] init --agent=gemini-cli

Örneğin, gcloud-mcp için:

npx @google-cloud/gcloud-mcp init --agent=gemini-cli

Başlatma işleminden sonra, aşağıdaki komutu çalıştırarak gcloud-mcp sunucusunun doğru şekilde yapılandırıldığını doğrulayabilirsiniz:

gemini mcp list

> ✓ gcloud: npx -y @google-cloud/gcloud-mcp (stdio) - Connected

Diğer yapay zeka istemcileri için

Bu depodaki MCP sunucularını diğer istemcilerle kullanmak için, her bir MCP sunucusu için ilgili JSON yapılandırma dosyalarına aşağıdaki parçacığı ekleyin:

"[SERVER_NAME]": {
  "command": "npx",
  "args": ["-y", "@google-cloud/[PACKAGE_NAME]"]
}

Örneğin, gcloud için:

"gcloud": {
  "command": "npx",
  "args": ["-y", "@google-cloud/gcloud-mcp"]
}

Popüler araçlar için talimatlar:

• Claude Desktop: Claude > Ayarlar > Geliştirici > Yapılandırmayı Düzenle'yi açın ve claude_desktop_config.json dosyasını düzenleyin.
• Cline: MCP Sunucuları simgesine tıklayın, ardından MCP Sunucularını Yapılandır'a tıklayarak cline_mcp_settings.json dosyasını düzenleyin.
• Cursor: Tek bir proje için .cursor/mcp.json dosyasını veya tüm projeler için ~/.cursor/mcp.json dosyasını düzenleyin.
• Gemini CLI (Manuel Kurulum): Uzantılar kullanılmıyorsa, tek bir proje için .gemini/settings.json dosyasını veya tüm projeler için ~/.gemini/settings.json dosyasını düzenleyin.

Visual Studio Code için, tek bir proje için çalışma alanınızdaki .vscode/mcp.json dosyasını veya tüm projeler için genel kullanıcı ayarları dosyanızı düzenleyin:

"servers": {
  "[SERVER_NAME]": {
    "command": "npx",
    "args": ["-y", "@google-cloud/[PACKAGE_NAME]"]
  }
}

Örneğin, gcloud ve observability için:

"servers": {
  "gcloud": {
    "command": "npx",
    "args": ["-y", "@google-cloud/gcloud-mcp"]
  },
  "observability": {
    "command": "npx",
    "args": ["-y", "@google-cloud/observability-mcp"]
  },
}

🛠 Yerel Geliştirme

Depoyu yerel olarak kurma hakkında daha fazla bilgi için lütfen development.md dosyasına bakın.

🧰 Mevcut MCP Araçları

MCP Sunucusu	Araç	Açıklama
gcloud	run_gcloud_command	Bir gcloud komutunu yürütür. Bazı komutların ajan tarafından yürütülmesi kısıtlanmıştır. Daha fazla bilgi için MCP İzinleri sayfasına bakın.
observability	list_log_entries	Bir projedeki günlük girişlerini listeler.
	list_log_names	Bir projedeki günlük adlarını listeler.
	list_buckets	Bir projedeki günlük kovalarını listeler.
	list_views	Bir projedeki günlük görünümlerini listeler.
	list_sinks	Bir projedeki günlük havuzlarını listeler.
	list_log_scopes	Bir projedeki günlük kapsamlarını listeler.
	list_metric_descriptors	Bir proje için metrik tanımlayıcılarını listeler.
	list_time_series	Belirli bir metrik için zaman serisi verilerini listeler.
	list_alert_policies	Bir projedeki uyarı politikalarını listeler.
	list_traces	Bir projede izleri arar.
	get_trace	Bir projede belirli bir izi kimliğe göre getirir.
	list_group_stats	Bir proje için hata gruplarını listeler.
storage	list_objects	Bir GCS kovasındaki nesneleri listeler.
	read_object_metadata	Belirli bir nesne için kapsamlı meta verileri okur.
	read_object_content	Belirli bir nesnenin içeriğini okur.
	delete_object	Bir kovadan belirli bir nesneyi siler.
	write_object	Bir kovaya yeni bir nesne yazar.
	update_object_metadata	Mevcut bir nesnenin özel meta verilerini günceller.
	copy_object	Bir nesneyi bir kovadan diğerine kopyalar.
	move_object	Bir nesneyi bir kovadan diğerine taşır.
	upload_object	Bir dosyayı GCS kovasına yükler.
	download_object	GCS'den yerel bir dosyaya bir nesne indirir.
	list_buckets	Bir projedeki tüm kovaları listeler.
	create_bucket	Yeni bir kova oluşturur.
	delete_bucket	Bir kovayı siler.
	get_bucket_metadata	Belirli bir kova için kapsamlı meta verileri getirir.
	update_bucket_labels	Bir kovanın etiketlerini günceller.
	get_bucket_location	Bir kovanın konumunu getirir.
	view_iam_policy	Bir kova için IAM politikasını görüntüler.
	check_iam_permissions	Bir kova için IAM izinlerini test eder.
	get_metadata_table_schema	GCS içgörü hizmetinin etkin olup olmadığını kontrol eder ve belirli bir içgörü veri kümesi yapılandırması için BigQuery tablo şemasını döndürür.
	execute_insights_query	Bir içgörü veri kümesine karşı BigQuery SQL sorgusu yürütür ve sonucu döndürür.
	list_insights_configs	Belirli bir proje için tüm Depolama İçgörüleri veri kümesi yapılandırmalarının adlarını listeler.
backupdr	list_backup_vaults	Belirli bir proje ve konumdaki tüm yedek kasalarını listeler.
	get_backup_vault	Belirli bir yedek kasasının ayrıntılarını getirir.
	list_backup_plans	Belirli bir proje ve konumdaki tüm yedek planlarını listeler.
	get_backup_plan	Belirli bir yedek planının ayrıntılarını getirir.
	list_backup_plan_associations	Yedek planları ile kaynaklar arasındaki tüm ilişkilendirmeleri listeler.
	get_backup_plan_association	Belirli bir yedek planı ilişkilendirmesinin ayrıntılarını getirir.
	list_datasources	Bir yedek kasasındaki tüm veri kaynaklarını listeler.
	get_datasource	Belirli bir veri kaynağının ayrıntılarını getirir.
	list_backups	Belirli bir veri kaynağı için tüm yedekleri listeler.
	get_backup	Belirli bir yedeğin ayrıntılarını getirir.
	find_protectable_resources	Korunabilecek kaynakları (VM'ler, Diskler, SQL) keşfeder.
	get_backupdr_operation	Uzun süren bir BackupDR işleminin durumunu alır.
	get_csql_operation	Uzun süren bir Cloud SQL işleminin durumunu alır.
	create_backup_vault	Belirtilen konumda yeni bir yedek kasası oluşturur.
	create_backup_plan	Tanımlanmış kurallar ve saklama ile yeni bir yedek planı oluşturur.
	update_backup_plan	Mevcut bir yedek planını değiştirir.
	create_backup_plan_association	Korumayı başlatmak için bir kaynağı bir yedek planıyla ilişkilendirir.
	restore_backup	Bir yedeği hedef Compute Engine örneğine veya diske geri yükler.
	csql_restore	Bir Cloud SQL yedeğini hedef örneğe geri yükler.
	delete_backup_vault	Bir yedek kasasını siler.
	delete_backup_plan	Bir yedek planını siler.
	delete_backup_plan_association	Bir kaynağın ilişkilendirmesini silerek korumasını kaldırır.
	delete_backup	Bir kasadan belirli bir yedeği siler.

🔑 MCP İzinleri

gcloud MCP'nin izinleri, aktif gcloud hesabının izinlerine doğrudan bağlıdır. İzinleri kısıtlamak ve en az ayrıcalık ilkesiyle çalışmak için, impersonation kullanarak bir hizmet hesabı olarak yetkilendirme yapabilir ve hizmet hesabına sınırlı izinlere sahip bir rol atayabilirsiniz.

Varsayılan olarak, gcloud MCP, AI aracıları için anlamlı olmayan gcloud komutlarının yürütülmesini engeller. Bu, rastgele girdiler çalıştırabilen ve etkileşimli oturumlar başlatabilen komutları kısıtlamak için yapılır. Engellenen komutların listesi için buraya bakın.

💫 Diğer Google Cloud MCP Sunucuları

Google Cloud şu diğer sunucuları sunar:

• Firebase MCP
• Google Analytics MCP
• Google Cloud Genmedia MCP
• Google Cloud Run MCP
• Google Kubernetes Engine (GKE) MCP
• Google Security Operations and Threat Intelligence MCP
• MCP Toolbox for Databases

👥 Katkıda Bulunma

Katkılarınızı bekliyoruz! Hata düzeltmeleri, geri bildirim paylaşımı veya dokümantasyon iyileştirmeleri olsun, katkılarınız memnuniyetle karşılanır. Başlamak için lütfen Katkıda Bulunma Kılavuzumuzu okuyun.

📄 Önemli Notlar

Bu depo şu anda önizleme aşamasındadır ve kırıcı değişiklikler görebilir. Bu depo, resmi olarak desteklenen bir Google ürünü değil, bir çözüm sunar. Google Cloud Hizmet Şartları kapsamında değildir. MCP spesifikasyonu, diğer SDK'lar veya diğer çözümler ve ürünler değiştiğinde bozulabilir. Ayrıca Güvenlik Politikamıza bakın.