Server MCP Dataform menyediakan alat untuk berinteraksi dengan Dataform.
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 Dataform API memiliki endpoint MCP global berikut:
- https://dataform.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 dataform.googleapis.com memiliki alat berikut:
| Alat MCP | |
|---|---|
list_repositories |
Mencantumkan repositori Dataform dalam project dan lokasi Google Cloud tertentu. Nilai parameter |
create_repository |
Membuat repositori Dataform baru di project dan lokasi Google Cloud tertentu. Alat ini menetapkan resource root yang diperlukan untuk semua aset transformasi lainnya, seperti hasil kompilasi dan konfigurasi alur kerja. Repositori harus dibuat sebelum alat MCP Dataform lainnya dapat digunakan. Mengaktifkan alat ini adalah langkah pertama dalam menyiapkan project Dataform. Nilai parameter Nilai parameter Hilangkan parameter |
commit_repository_changes |
Terapkan commit Git untuk mencatat status file dalam repositori Dataform. Alat ini terutama ditujukan untuk mengelola aset file tunggal—seperti notebook atau kueri tersimpan—yang berada langsung di repositori. Alat ini tidak digunakan dalam alur kerja pipeline umum yang memerlukan ruang kerja. Jangan gunakan alat ini pada repositori yang terhubung ke host Git jarak jauh. Untuk memverifikasi, gunakan alat Tindakan commit ini akan membuat entri permanen dalam histori Git internal repositori. Nilai parameter |
read_repository_file |
Menampilkan konten file yang ada di dalam repositori Dataform. Alat ini bukan untuk pengembangan pipeline standar. Tujuannya adalah untuk interaksi repositori langsung, biasanya untuk mengelola aset file tunggal seperti notebook atau kueri tersimpan. Jangan gunakan alat ini pada repositori yang terhubung ke host Git jarak jauh. Untuk memverifikasi, gunakan alat Nilai parameter Nilai parameter |
query_repository_directory_contents |
Menampilkan konten direktori repositori Dataform tertentu. Alat ini terutama digunakan untuk mencantumkan dan mengelola aset file tunggal secara langsung di repositori. Jangan gunakan alat ini pada repositori yang terhubung ke host Git jarak jauh. Untuk memverifikasi, gunakan alat Nilai parameter Nilai parameter |
list_workflow_configs |
Mencantumkan konfigurasi alur kerja dalam repositori Dataform tertentu. Nilai parameter |
get_workflow_config |
Mengambil satu konfigurasi alur kerja Dataform. Nilai parameter |
create_workflow_config |
Buat konfigurasi alur kerja baru di repositori Dataform tertentu. Nilai parameter
Konfigurasi alur kerja menyandingkan Prasyarat: Anda harus membuat Pemanggilan alur kerja yang dibuat dari konfigurasi alur kerja ini berjalan di akun layanan kustom. Untuk menentukan akun layanan ini, tetapkan nilai parameter |
update_workflow_config |
Perbarui properti konfigurasi alur kerja Dataform yang ada, seperti jadwal eksekusinya (cron), konfigurasi rilis terkait, atau penggantian pemanggilan. Modifikasi pada Nilai parameter Nilai parameter Pemanggilan alur kerja yang dibuat dari konfigurasi alur kerja ini berjalan di akun layanan kustom. Untuk menentukan akun layanan ini, tetapkan nilai parameter |
list_release_configs |
Mencantumkan konfigurasi rilis di repositori Dataform tertentu. Nilai parameter |
get_release_config |
Mengambil satu konfigurasi rilis Dataform. Nilai parameter |
create_release_config |
Membuat konfigurasi rilis baru di repositori Dataform tertentu. Nilai parameter
Jangan sertakan nilai parameter |
update_release_config |
Memperbarui konfigurasi rilis Dataform yang ada, yang berfungsi sebagai template untuk kompilasi kode otomatis. Perubahan pada kolom seperti Hilangkan nilai parameter Nilai parameter |
create_compilation_result |
Membuat hasil kompilasi Dataform baru di project dan lokasi Google Cloud tertentu. Alat ini mengompilasi file Nilai parameter Agen dapat memvalidasi SQL yang dikompilasi dengan memeriksa resource Hasil kompilasi yang valid diperlukan sebelum memicu pemanggilan alur kerja manual menggunakan alat Prasyarat: Buat repositori menggunakan alat |
list_workflow_invocations |
Mencantumkan pemanggilan alur kerja dalam repositori Dataform tertentu. Nilai parameter |
create_workflow_invocation |
Buat pemanggilan alur kerja baru di repositori Dataform tertentu. Nilai parameter Nilai parameter
Prasyarat: Untuk memicu pemanggilan, Anda harus membuat Pemanggilan alur kerja berjalan di akun layanan yang ditentukan oleh sumber kompilasi:
Akun layanan tidak boleh menjadi agen layanan Dataform default. Akun layanan harus memiliki izin yang diperlukan untuk menjalankan alur kerja, dan pengguna harus diizinkan untuk bertindak sebagai akun layanan yang dipilih. Otorisasi ini biasanya diberikan melalui peran Pengguna Akun Layanan ( |
cancel_workflow_invocation |
Meminta penghentian tuntas pemanggilan alur kerja Dataform yang sedang berjalan. Alat ini mengirimkan sinyal pembatalan ke alur kerja yang sedang berjalan. Namun, setiap tugas BigQuery, pembuatan tabel, atau pernyataan yang telah selesai sebagai bagian dari alur kerja ini tidak akan di-roll back. Nilai parameter |
get_compilation_result |
Mengambil satu hasil kompilasi Dataform. Nilai parameter |
query_compilation_actions |
Menampilkan tindakan hasil kompilasi untuk hasil kompilasi Dataform tertentu. Nilai parameter |
query_workflow_invocation_actions |
Menampilkan tindakan pemanggilan alur kerja untuk pemanggilan alur kerja Dataform tertentu. Tindakan ini mewakili tugas BigQuery, pembuatan tabel, atau pernyataan individual yang membentuk alur kerja. Nilai parameter |
get_workflow_invocation |
Mengambil satu pemanggilan alur kerja Dataform. Nilai parameter |
list_workspaces |
Mencantumkan ruang kerja pengembangan di repositori Dataform tertentu. Gunakan alat ini untuk menemukan ruang kerja yang ada sebelum melakukan operasi file (menggunakan alat seperti Nilai parameter |
get_workspace |
Mengambil satu ruang kerja pengembangan Dataform. Nilai parameter Jika Anda tidak mengetahui nama ruang kerja yang tepat, gunakan alat |
create_workspace |
Membuat ruang kerja pengembangan baru di repositori Dataform tertentu. Ruang kerja adalah checkout repositori yang terisolasi dan dapat diedit. Gunakan ruang kerja saat Anda perlu menulis atau merevisi kode pipeline di beberapa file dan memvalidasinya sebelum melakukan commit. Edit file di ruang kerja dengan alat Jangan gunakan alat Prasyarat: Repositori induk harus ada. Nilai parameter Nilai parameter Nilai parameter |
query_directory_contents |
Menampilkan konten direktori tertentu di dalam ruang kerja Dataform. Gunakan alat ini untuk menemukan jalur file yang valid sebelum memanggil alat Nilai parameter Nilai parameter |
search_files |
Menemukan file dan direktori di ruang kerja Dataform yang cocok dengan filter penelusuran. Gunakan alat ini, bukan mencantumkan direktori secara rekursif dengan alat Nilai parameter Nilai parameter |
read_file |
Menampilkan konten file di dalam ruang kerja Dataform, termasuk perubahan yang belum di-commit. Gunakan alat ini untuk membaca file Untuk membaca file yang di-commit langsung dari repositori tanpa ruang kerja, gunakan alat Nilai parameter Nilai parameter Nilai parameter |
write_file |
Menulis konten file di dalam ruang kerja Dataform, membuat file jika tidak ada. Nilai parameter Nilai parameter Nilai parameter Nilai parameter |
remove_file |
Menghapus file di dalam ruang kerja Dataform. Penghapusan tetap tidak dilakukan hingga alat Nilai parameter Nilai parameter |
make_directory |
Membuat direktori di dalam ruang kerja Dataform, termasuk direktori induk yang tidak ada. Nilai parameter Nilai parameter |
commit_workspace_changes |
Merekam commit Git untuk perubahan yang tidak di-commit di ruang kerja Dataform. Penerapan tetap berada di ruang kerja hingga dipublikasikan dengan alat Secara default, semua perubahan yang belum di-commit akan di-commit. Untuk melakukan commit hanya pada sebagian file, berikan nilai parameter Nilai parameter Nilai parameter Nilai parameter |
push_git_commits |
Mengirimkan perubahan yang di-commit ruang kerja Dataform ke remote Git repositori. Prasyarat: Anda harus melakukan perubahan ruang kerja menggunakan alat Jika Anda berencana menggunakan alat Nilai parameter Nilai parameter |
get_repository |
Mengambil satu repositori Dataform, termasuk setelan jarak jauh Git, penggantian kompilasi ruang kerja, dan akun layanan default. Gunakan alat ini untuk memeriksa kolom Nilai parameter Jika Anda tidak mengetahui nama repositori yang tepat, gunakan alat |
update_repository |
Perbarui properti repositori Dataform yang ada, seperti setelan Git jarak jauh, penggantian kompilasi ruang kerja, atau akun layanan default. Prasyarat: Gunakan alat Jika nilai parameter Nilai parameter |
create_folder |
Membuat folder Dataform baru di project dan lokasi Google Cloud tertentu. Folder mengatur repositori Dataform ke dalam hierarki. Membuat folder tidak akan memindahkan repositori apa pun ke dalamnya. Untuk menempatkan repositori di dalam folder, tetapkan nilai parameter Jangan mencoba memindahkan repositori yang ada ke dalam folder menggunakan alat Nilai parameter Nilai parameter |
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://dataform.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |