MCP Reference: bigquery.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, 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.

Server MCP BigQuery menyediakan alat untuk berinteraksi dengan BigQuery

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. Ini adalah titik kontak bagi LLM untuk meminta konteks, memanggil alat, atau mengakses resource. Endpoint MCP Google dapat bersifat global atau regional.

Server MCP bigquery.googleapis.com memiliki endpoint MCP berikut:

  • https://bigquery.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.

Server MCP bigquery.googleapis.com memiliki alat berikut:

Alat MCP
list_dataset_ids Mencantumkan ID set data BigQuery dalam project Google Cloud.
get_dataset_info Mendapatkan informasi metadata tentang set data BigQuery.
list_table_ids Mencantumkan ID tabel dalam set data BigQuery.
get_table_info Mendapatkan informasi metadata tentang tabel BigQuery.
execute_sql_readonly

Menjalankan kueri SQL hanya baca dalam project dan menampilkan hasilnya. Sebaiknya gunakan alat ini daripada execute_sql jika memungkinkan.

Alat ini hanya dibatasi untuk pernyataan SELECT. Pernyataan dan prosedur tersimpan INSERT, UPDATE, dan DELETE tidak diizinkan. Jika kueri tidak menyertakan pernyataan SELECT, error akan ditampilkan. Untuk mengetahui informasi tentang cara membuat kueri, lihat dokumentasi GoogleSQL.

Kueri yang dijalankan menggunakan alat execute_sql_readonly akan otomatis menetapkan label tugas goog-mcp-server: true. Kueri ditagih ke project yang ditentukan di kolom project_id.
execute_sql

Jalankan kueri SQL dalam project dan tampilkan hasilnya. Sebaiknya gunakan alat execute_sql_readonly jika memungkinkan.

Alat ini dapat menjalankan kueri apa pun yang didukung BigQuery, termasuk: * Kueri SQL (SELECT, INSERT, UPDATE, DELETE, CREATE, dll.) * Fungsi AI/ML seperti AI.FORECAST, ML.EVALUATE, ML.PREDICT * Kueri lain yang didukung BigQuery.

Kueri yang dijalankan menggunakan alat execute_sql akan otomatis menetapkan label tugas goog-mcp-server: true. Kueri ditagih ke project yang ditentukan di kolom project_id.

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://bigquery.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'