MCP Reference: maintenance.googleapis.com

Server Model Context Protocol (MCP) bertindak sebagai proxy antara layanan eksternal yang menyediakan konteks, data, atau kemampuan ke Model Bahasa Besar (LLM) atau aplikasi AI. Server MCP menghubungkan aplikasi AI ke sistem eksternal seperti database dan layanan web, serta menerjemahkan responsnya ke dalam format yang dapat dipahami oleh aplikasi AI.

Penyiapan Server

Anda harus mengaktifkan server MCP dan menyiapkan autentikasi sebelum digunakan. Untuk mengetahui informasi selengkapnya tentang cara menggunakan server MCP jarak jauh Google dan Google Cloud, lihat Ringkasan server MCP Google Cloud.

Endpoint Server

Endpoint layanan MCP adalah alamat jaringan dan antarmuka komunikasi (biasanya URL) server MCP yang digunakan aplikasi AI (Host untuk klien MCP) untuk membuat koneksi yang aman dan standar. Agen ini adalah titik kontak bagi LLM untuk meminta konteks, memanggil alat, atau mengakses resource. Endpoint MCP Google dapat bersifat global atau regional.

Server MCP Maintenance API memiliki endpoint MCP global berikut:

  • https://maintenance.googleapis.com/mcp

Alat MCP

Alat MCP adalah fungsi atau kemampuan yang dapat dieksekusi yang diekspos server MCP ke aplikasi LLM atau AI untuk melakukan tindakan di dunia nyata.

Alat

Server MCP maintenance.googleapis.com memiliki alat berikut:

Alat MCP
list_resource_maintenances

Mencantumkan pemeliharaan resource untuk project dan lokasi tertentu.

Parameter

  • parent (string, Wajib): Induk pemeliharaan resource, dalam format projects/{project}/locations/{location}.
  • page_size (integer, Opsional): Jumlah maksimum pemeliharaan resource yang akan dikirim per halaman.
  • page_token (string, Opsional): Token halaman, yang diterima dari panggilan ListResourceMaintenances sebelumnya.
  • filter (string, Opsional): Memfilter daftar seperti yang ditentukan di https://google.aip.dev/160.
  • order_by (string, Opsional): Urutkan hasil seperti yang ditentukan dalam https://google.aip.dev/132.

Nilai Hasil

Metode ini menampilkan objek ListResourceMaintenancesResponse, yang berisi:

  • resource_maintenances: Daftar pemeliharaan resource yang cocok dengan kriteria permintaan.
  • next_page_token: Token yang dapat dikirim sebagai page_token dalam permintaan berikutnya untuk mengambil halaman hasil berikutnya.

Catatan

  • Gunakan '-' sebagai lokasi untuk tampilan global di semua wilayah.
get_resource_maintenance

Mengambil detail tentang pemeliharaan resource tertentu.

Parameter

  • name (string, Wajib): Nama resource dari resource dalam layanan, dalam format projects/{project}/locations/{location}/resourceMaintenances/{resource_maintenance_id}.

Nilai Hasil

Objek resource ResourceMaintenance jika ditemukan.
summarize_maintenances

Merangkum pemeliharaan untuk project dan lokasi tertentu dengan memberikan statistik gabungan.

Parameter

  • parent (string, Wajib): Induk pemeliharaan resource, dalam format projects/{project}/locations/{location}.
  • page_size (integer, Opsional): Jumlah maksimum pemeliharaan resource yang akan dikirim per halaman.
  • page_token (string, Opsional): Token halaman, yang diterima dari panggilan SummarizeMaintenances sebelumnya.
  • filter (string, Opsional): Memfilter daftar seperti yang ditentukan di https://google.aip.dev/160.
  • order_by (string, Opsional): Urutkan hasil seperti yang ditentukan dalam https://google.aip.dev/132.

Nilai Hasil

Metode ini menampilkan objek SummarizeMaintenancesResponse, yang berisi:

  • maintenances: Daftar ringkasan pemeliharaan.
  • next_page_token: Token yang dapat dikirim sebagai page_token dalam permintaan berikutnya untuk mengambil halaman hasil berikutnya.

Catatan

  • Gunakan '-' sebagai lokasi untuk ringkasan global di semua wilayah.

Mendapatkan spesifikasi alat MCP

Untuk mendapatkan spesifikasi alat MCP untuk semua alat di server MCP, gunakan metode tools/list. Contoh berikut menunjukkan cara menggunakan curl untuk mencantumkan semua alat dan spesifikasinya yang saat ini tersedia dalam server MCP.

Permintaan Curl 
                      
curl --location 'https://maintenance.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'