Gemini Cloud Assist

Server MCP Gemini Cloud Assist

[!IMPORTANT] Pemberitahuan Pratinjau Privat API server MCP Gemini Cloud Assist saat ini dalam Pratinjau Privat dan berada di belakang daftar izin. Silakan hubungi tim akun Google Cloud Anda untuk meminta akses.

[!WARNING] Pemberitahuan Depresiasi & Migrasi ke Server MCP Jarak Jauh

Server MCP Gemini Cloud Assist telah bermigrasi dari arsitektur Node.js lokal ke arsitektur Server MCP Jarak Jauh. Server Node.js lokal yang lama akan kehilangan dukungan dalam beberapa bulan mendatang.

Untuk menggunakan Server MCP Jarak Jauh yang baru, gunakan versi v0.8.0 atau yang lebih baru. Jika Anda ingin terus menggunakan server lokal lama selama masa transisi, harap kunci konfigurasi Anda ke versi yang lebih lama.

Server ini menghubungkan klien Model Context Protocol (MCP) ke API Gemini Cloud Assist. Ini memungkinkan Anda menggunakan bahasa alami untuk memahami, mengelola, dan memecahkan masalah lingkungan Google Cloud Anda langsung dari baris perintah lokal.

[!NOTE] Persyaratan Layanan Google Cloud Platform (tersedia di https://cloud.google.com/terms/) dan Ketentuan Pemrosesan Data dan Keamanan (tersedia di https://cloud.google.com/terms/data-processing-terms) tidak berlaku untuk komponen apa pun dari perangkat lunak Server MCP Gemini Cloud Assist.

Untuk mempelajari lebih lanjut tentang Gemini Cloud Assist, lihat Ringkasan Gemini Cloud Assist di dokumentasi Google Cloud.

✨ Fitur utama

• Desain infrastruktur: Buat dan arsitektur konfigurasi infrastruktur untuk Google Cloud.
• Pecahkan masalah: Jalankan investigasi mendalam untuk menemukan akar penyebab masalah kompleks di lingkungan Google Cloud Anda.
• Kelola sumber daya: Buat, perbarui, dan hapus sumber daya Google Cloud langsung dari alur kerja obrolan Anda (memerlukan Tindakan Agen).
• Optimalkan biaya: Analisis pengeluaran Anda, lacak biaya, dan identifikasi peluang efisiensi seperti sumber daya yang tidak terpakai.
• Dapatkan bantuan umum: Ajukan pertanyaan dan dapatkan panduan tentang praktik terbaik, arsitektur, dan operasi Google Cloud.

Memulai dengan cepat

Sebelum memulai, pastikan Anda telah menyiapkan hal-hal berikut:

• Google Cloud SDK terinstal dan dikonfigurasi.
• Proyek Google Cloud.
• Peran IAM berikut pada akun pengguna Anda:
  • roles/serviceusage.serviceUsageAdmin: Diperlukan untuk mengaktifkan API Cloud Assist.
  • roles/geminicloudassist.user: Diperlukan untuk membuat permintaan ke API Cloud Assist.

Langkah 1: Autentikasi ke Google Cloud

Server MCP Gemini Cloud Assist menggunakan Kredensial Default Aplikasi (ADC) lokal untuk mengautentikasi dengan aman ke Google Cloud. Untuk menyiapkan ADC, jalankan perintah gcloud berikut:

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

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

Konfigurasikan klien MCP Anda

Konfigurasi klien-agen bergantung pada agen yang Anda gunakan.

Antigravity

Tambahkan yang berikut ke mcp_config.json Anda:

"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

1. Di proyek Google Cloud Anda, buat ID klien OAuth 2.0 untuk aplikasi desktop.
2. Konfigurasikan URI://anysphere.cursor-mcp/oauth/callback sebagai URL pengalihan.
3. Tambahkan atau gabungkan blok konfigurasi berikut:

{
  "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

Ikuti petunjuk konfigurasi untuk aplikasi spesifik Anda:

• Claude.ai

Alat MCP

Alat MCP Gemini Cloud Assist

Gemini Cloud Assist adalah agen yang dapat diakses melalui serangkaian alat MCP. Agen yang dipanggil oleh panggilan alat MCP melakukan panggilan alatnya sendiri secara internal ke Google Cloud. Alat MCP berikut diterbitkan untuk dikonsumsi oleh agen:

Alat	Deskripsi
ask_cloud_assist	Antarmuka utama untuk bantuan Google Cloud dan untuk agen Gemini Cloud Assist. Semua fungsionalitas dapat diakses melalui alat ini.
design_infra	Mendukung alur kerja untuk mendesain dan mengarsitektur infrastruktur di Google Cloud.
investigate_issue	Mendukung alur kerja untuk pemecahan masalah di Google Cloud. Dapat melakukan pemecahan masalah cepat atau pemecahan masalah yang lebih mendalam melalui sumber daya Investigasi.
invoke_operation	Mendukung alur kerja untuk membuat, memperbarui, dan menghapus sumber daya di Google Cloud. Hanya berfungsi saat Tindakan Agen diaktifkan.
optimize_costs	Mendukung alur kerja untuk menganalisis, melacak, dan mengoptimalkan biaya Google Cloud. Memberikan rincian pengeluaran dan mengidentifikasi peluang efisiensi biaya.

Alat MCP Pusat Desain Aplikasi

Alat MCP Pusat Desain Aplikasi, yang sering diorkestrasi oleh alat design_infra GCA, mengelola siklus hidup aplikasi infrastruktur menggunakan Pusat Desain Aplikasi, termasuk manajemen templat, kepatuhan keamanan, remediasi, dan penerapan.

Alat	Deskripsi
setup_adc	Menginisialisasi lingkungan Pusat Desain Aplikasi. Ini adalah langkah penyiapan satu kali yang harus dilakukan sebelum alat ADC lainnya dapat digunakan.
manage_application	Mengelola siklus hidup penerapan aplikasi. Gunakan alat ini untuk menerapkan desain terverifikasi menggunakan Pusat Desain Aplikasi atau mengambil status dan detail penerapan yang ada. Ini adalah langkah terakhir yang mengubah desain Anda menjadi infrastruktur yang diterapkan di Google Cloud.
manage_application_template	Mengelola konten Infrastruktur sebagai Kode (IaC) dari desain infrastruktur Anda. Gunakan ini untuk menyimpan desain sebagai templat Pusat Desain Aplikasi, mengekspor desain sebagai file Terraform, atau memperbarui desain (misalnya komponen, konfigurasi parameter, dll).
assess_best_practices	Melakukan audit keamanan dan konfigurasi menyeluruh pada desain aplikasi Anda sebelum penerapan. Ini memvalidasi desain terhadap kerangka kerja Security Command Center dan kontrol yang relevan, mengembalikan laporan dengan temuan yang dapat ditindaklanjuti untuk remediasi.
list_application_templates	Mencantumkan semua desain aplikasi yang tersedia.

Catatan: Alat-alat ini tidak boleh diperlakukan sebagai API yang stabil. Parameter dapat diubah namanya atau dimodifikasi untuk memperhitungkan kemampuan Gemini Cloud Assist yang terus berkembang.

Keterampilan Agen

Alat MCP Gemini Cloud Assist memanfaatkan file SKILL.md untuk menginstruksikan agen Anda tentang cara menggunakan alat dengan benar. Keterampilan membantu memandu agen Anda dalam merangkai beberapa alat menjadi alur kerja, meneruskan informasi lokal yang relevan ke Gemini Cloud Assist, dan mengaktifkan pemanggilan eksplisit.

Keterampilan	Deskripsi
designing-and-deploying-infrastructure	Memandu agen tentang cara mendesain, menilai, menerapkan, dan memecahkan masalah infrastruktur cloud menggunakan Pusat Desain Aplikasi (ADC) dan alat Gemini Cloud Assist.
operating-google-cloud	Memberikan instruksi untuk mengelola sumber daya Google Cloud Platform (GCP) dan Kubernetes menggunakan alat MCP khusus.

Berkontribusi

• Jika Anda menemukan bug, silakan ajukan masalah di halaman Masalah GitHub kami.
• Sebelum mengirim permintaan tarik, harap tinjau Panduan Kontribusi kami.

Lisensi

Proyek ini dilisensikan di bawah Lisensi Apache 2.0 dan disediakan apa adanya, tanpa jaminan atau representasi untuk penggunaan atau tujuan apa pun. Untuk detailnya, lihat file LISENSI.