Gemini Cloud Assist

Server MCP Gemini Cloud Assist

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

[!PERINGATAN] Pemberitahuan Penghentian & 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 lebih lama akan kehilangan dukungan dalam beberapa bulan mendatang.

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

Server ini menghubungkan klien Model Context Protocol (MCP) seperti Gemini CLI 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.

[!CATATAN] Ketentuan Layanan Google Cloud Platform (tersedia di https://cloud.google.com/terms/) dan Ketentuan Pemrosesan dan Keamanan Data (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

• Mendesain infrastruktur: Membuat dan merancang konfigurasi infrastruktur untuk Google Cloud.
• Memecahkan masalah: Menjalankan investigasi mendalam untuk menemukan akar penyebab masalah kompleks di lingkungan Google Cloud Anda.
• Mengelola sumber daya: Membuat, memperbarui, dan menghapus sumber daya Google Cloud langsung dari alur kerja obrolan Anda (memerlukan Tindakan Agen).
• Mengoptimalkan biaya: Menganalisis pengeluaran Anda, melacak biaya, dan mengidentifikasi peluang efisiensi seperti sumber daya yang menganggur.
• Mendapatkan bantuan umum: Mengajukan pertanyaan dan mendapatkan panduan tentang praktik terbaik, arsitektur, dan operasi Google Cloud.

Mulai cepat

Sebelum memulai, pastikan Anda telah menyiapkan hal berikut:

• Google Cloud SDK terinstal dan dikonfigurasi.
• Sebuah 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 agen-klien bergantung pada agen mana yang Anda gunakan.

Gemini CLI

Instal server MCP sebagai ekstensi Gemini CLI:

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

Atau, Anda dapat menambahkan konfigurasi secara manual ke ~/.gemini/settings.json Anda:

"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

Tambahkan yang berikut ini 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 client ID 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 membuat panggilan alatnya sendiri secara internal ke Google Cloud. Alat MCP berikut diterbitkan untuk digunakan 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 merancang infrastruktur di Google Cloud.
investigate_issue	Mendukung alur kerja untuk pemecahan masalah di Google Cloud. Dapat melakukan pemecahan masalah cepat atau pemecahan masalah lebih dalam 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. Menyediakan rincian pengeluaran dan mengidentifikasi peluang untuk 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 template, kepatuhan keamanan dan remediasi, serta 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 yang telah diverifikasi 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 Infrastructure as Code (IaC) dari desain infrastruktur Anda. Gunakan ini untuk menyimpan desain sebagai template Pusat Desain Aplikasi, mengekspor desain sebagai file Terraform, atau memperbarui desain (misalnya komponen, konfigurasi parameter, dll.).
assess_best_practices	Melakukan audit keamanan dan konfigurasi yang komprehensif 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 diganti nama atau dimodifikasi untuk mengakomodasi 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 ini membantu memandu agen Anda dalam merangkai beberapa alat menjadi satu alur kerja, meneruskan informasi lokal yang relevan ke Gemini Cloud Assist, dan memungkinkan pemanggilan eksplisit.

Keterampilan	Deskripsi
designing-and-deploying-infrastructure	Memandu agen tentang cara mendesain, menilai, menerapkan, dan memecahkan masalah infrastruktur cloud menggunakan alat Pusat Desain Aplikasi (ADC) dan Gemini Cloud Assist.
operating-google-cloud	Menyediakan 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 GitHub Issues kami.
• Sebelum mengirimkan pull request, harap tinjau Panduan Berkontribusi kami.

Lisensi

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