Google Cloud MCP Server

Server MCP gcloud ☁️

Server Model Context Protocol (MCP) gcloud memungkinkan asisten AI untuk berinteraksi dengan mudah dengan lingkungan Google Cloud menggunakan CLI gcloud. Dengan server MCP gcloud, Anda dapat:

• Berinteraksi dengan Google Cloud menggunakan bahasa alami. Jelaskan hasil yang Anda inginkan alih-alih menghafal sintaks perintah, flag, dan argumen yang rumit.
• Mengotomatiskan dan menyederhanakan alur kerja yang kompleks. Rangkaikan beberapa operasi cloud menjadi satu perintah yang dapat diulang untuk mengurangi upaya manual dan kemungkinan kesalahan.
• Menurunkan hambatan masuk untuk pengelolaan cloud. Berdayakan anggota tim yang kurang familier dengan gcloud untuk melakukan tindakan yang andal dengan percaya diri dan aman.

📡 Server MCP yang Tersedia

Repositori ini juga menyediakan server MCP lain selain server MCP gcloud. Daftar terbaru ada di bawah, dan tautan ke server MCP Google Cloud lainnya yang dihosting di luar repositori ini tersedia di sini.

Nama Server MCP	Deskripsi	Nama Paket	Versi
gcloud	Berinteraksi dengan Google Cloud melalui CLI gcloud menggunakan prompt bahasa alami.	gcloud-mcp
observability	Mengakses API Google Cloud Observability untuk melakukan kueri log, metrik, dan trace.	observability-mcp
storage	Berinteraksi dengan Google Cloud Storage untuk pengelolaan bucket dan objek.	storage-mcp
backupdr	Berinteraksi dengan Google Cloud Backup and Disaster Recovery.	backupdr-mcp

🚀 Memulai

Prasyarat

• Node.js: versi 20 atau lebih tinggi
• CLI gcloud

✨ Menyiapkan server MCP Anda

Gemini CLI dan Gemini Code Assist

Untuk mengintegrasikan server MCP dengan Gemini CLI atau Gemini Code Assist, jalankan perintah penyiapan di bawah ini dari direktori home Anda untuk server MCP yang tercantum dalam tabel. Ini akan menginstal server MCP sebagai ekstensi Gemini CLI untuk pengguna saat ini, sehingga tersedia untuk semua proyek Anda.

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

Misalnya, untuk gcloud-mcp:

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

Setelah proses inisialisasi, Anda dapat memverifikasi bahwa server gcloud-mcp telah dikonfigurasi dengan benar dengan menjalankan perintah berikut:

gemini mcp list

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

Untuk klien AI lainnya

Untuk menggunakan server MCP di repositori ini dengan klien lain, tambahkan cuplikan berikut ke file konfigurasi JSON masing-masing untuk setiap server MCP:

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

Misalnya, untuk gcloud:

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

Petunjuk untuk alat populer:

• Claude Desktop: Buka Claude > Settings > Developer > Edit Config dan edit claude_desktop_config.json.
• Cline: Klik ikon MCP Servers, lalu Configure MCP Servers untuk mengedit cline_mcp_settings.json.
• Cursor: Edit .cursor/mcp.json untuk satu proyek atau ~/.cursor/mcp.json untuk semua proyek.
• Gemini CLI (Penyiapan Manual): Jika tidak menggunakan ekstensi, edit .gemini/settings.json untuk satu proyek atau ~/.gemini/settings.json untuk semua proyek.

Untuk Visual Studio Code, edit file .vscode/mcp.json di ruang kerja Anda untuk satu proyek atau file pengaturan pengguna global Anda untuk semua proyek:

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

Misalnya, untuk gcloud dan observability:

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

🛠 Pengembangan Lokal

Untuk informasi lebih lanjut mengenai penginstalan repositori secara lokal, silakan lihat development.md

🧰 Alat MCP yang Tersedia

Server MCP	Alat	Deskripsi
gcloud	run_gcloud_command	Menjalankan perintah gcloud. Beberapa perintah dibatasi eksekusinya oleh agen. Lihat Izin MCP untuk informasi lebih lanjut.
observability	list_log_entries	Mencantumkan entri log dari sebuah proyek.
	list_log_names	Mencantumkan nama log dari sebuah proyek.
	list_buckets	Mencantumkan bucket log dari sebuah proyek.
	list_views	Mencantumkan tampilan log dari sebuah proyek.
	list_sinks	Mencantumkan sink log dari sebuah proyek.
	list_log_scopes	Mencantumkan cakupan log dari sebuah proyek.
	list_metric_descriptors	Mencantumkan deskriptor metrik untuk sebuah proyek.
	list_time_series	Mencantumkan data deret waktu untuk metrik tertentu.
	list_alert_policies	Mencantumkan kebijakan pemberitahuan dalam sebuah proyek.
	list_traces	Mencari trace dalam sebuah proyek.
	get_trace	Mendapatkan trace tertentu berdasarkan id dalam sebuah proyek.
	list_group_stats	Mencantumkan grup error untuk sebuah proyek.
storage	list_objects	Mencantumkan objek dalam bucket GCS.
	read_object_metadata	Membaca metadata lengkap untuk objek tertentu.
	read_object_content	Membaca konten objek tertentu.
	delete_object	Menghapus objek tertentu dari bucket.
	write_object	Menulis objek baru ke bucket.
	update_object_metadata	Memperbarui metadata kustom objek yang sudah ada.
	copy_object	Menyalin objek dari satu bucket ke bucket lain.
	move_object	Memindahkan objek dari satu bucket ke bucket lain.
	upload_object	Mengunggah file ke bucket GCS.
	download_object	Mengunduh objek dari GCS ke file lokal.
	list_buckets	Mencantumkan semua bucket dalam sebuah proyek.
	create_bucket	Membuat bucket baru.
	delete_bucket	Menghapus bucket.
	get_bucket_metadata	Mendapatkan metadata lengkap untuk bucket tertentu.
	update_bucket_labels	Memperbarui label untuk bucket.
	get_bucket_location	Mendapatkan lokasi bucket.
	view_iam_policy	Melihat kebijakan IAM untuk bucket.
	check_iam_permissions	Menguji izin IAM untuk bucket.
	get_metadata_table_schema	Memeriksa apakah layanan GCS insights diaktifkan dan mengembalikan skema tabel BigQuery untuk konfigurasi dataset insights tertentu.
	execute_insights_query	Menjalankan kueri SQL BigQuery terhadap dataset insights dan mengembalikan hasilnya.
	list_insights_configs	Mencantumkan nama semua konfigurasi dataset Storage Insights untuk proyek tertentu.
backupdr	list_backup_vaults	Mencantumkan semua vault cadangan dalam proyek dan lokasi tertentu.
	get_backup_vault	Mendapatkan detail vault cadangan tertentu.
	list_backup_plans	Mencantumkan semua rencana cadangan dalam proyek dan lokasi tertentu.
	get_backup_plan	Mendapatkan detail rencana cadangan tertentu.
	list_backup_plan_associations	Mencantumkan semua asosiasi antara rencana cadangan dan sumber daya.
	get_backup_plan_association	Mendapatkan detail asosiasi rencana cadangan tertentu.
	list_datasources	Mencantumkan semua sumber data dalam vault cadangan.
	get_datasource	Mendapatkan detail sumber data tertentu.
	list_backups	Mencantumkan semua cadangan untuk sumber data tertentu.
	get_backup	Mendapatkan detail cadangan tertentu.
	find_protectable_resources	Menemukan sumber daya (VM, Disk, SQL) yang dapat dilindungi.
	get_backupdr_operation	Mengambil status operasi BackupDR yang berjalan lama.
	get_csql_operation	Mengambil status operasi Cloud SQL yang berjalan lama.
	create_backup_vault	Membuat vault cadangan baru di lokasi tertentu.
	create_backup_plan	Membuat rencana cadangan baru dengan aturan dan retensi yang ditentukan.
	update_backup_plan	Memodifikasi rencana cadangan yang sudah ada.
	create_backup_plan_association	Mengasosiasikan sumber daya dengan rencana cadangan untuk memulai perlindungan.
	restore_backup	Memulihkan cadangan ke instance atau disk Compute Engine target.
	csql_restore	Memulihkan cadangan Cloud SQL ke instance target.
	delete_backup_vault	Menghapus vault cadangan.
	delete_backup_plan	Menghapus rencana cadangan.
	delete_backup_plan_association	Menghapus perlindungan dari sumber daya dengan menghapus asosiasinya.
	delete_backup	Menghapus cadangan tertentu dari brankas.

🔑 Izin MCP

Izin gcloud MCP terikat langsung dengan izin akun gcloud yang aktif. Untuk membatasi izin dan beroperasi dengan prinsip hak istimewa terendah, Anda dapat mengotorisasi sebagai akun layanan menggunakan peniruan identitas dan menetapkan akun layanan tersebut sebuah peran dengan izin terbatas.

Secara bawaan, gcloud MCP mencegah eksekusi perintah gcloud yang tidak masuk akal untuk agen AI. Ini dilakukan untuk membatasi perintah yang dapat menjalankan masukan arbitrer dan memulai sesi interaktif. Lihat di sini untuk daftar perintah yang ditolak.

💫 Server MCP Google Cloud Lainnya

Google Cloud menawarkan server-server lain ini:

• 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

👥 Berkontribusi

Kami menyambut kontribusi! Baik Anda memperbaiki bug, berbagi umpan balik, atau meningkatkan dokumentasi, kontribusi Anda sangat diterima. Silakan baca Panduan Berkontribusi kami untuk memulai.

📄 Catatan Penting

Repositori ini saat ini dalam pratinjau dan mungkin mengalami perubahan yang dapat merusak. Repositori ini menyediakan solusi, bukan produk Google yang didukung secara resmi. Repositori ini tidak tercakup dalam Ketentuan Layanan Google Cloud. Ini dapat rusak ketika spesifikasi MCP, SDK lain, atau ketika solusi dan produk lain berubah. Lihat juga Kebijakan Keamanan kami.