Bagaimana cara menambahkan alat atau ekstensi khusus ke Gemini Cli

Memperluas Gemini Cli dengan alat khusus melalui MCP

Gemini CLI dirancang agar dapat diperluas melalui model konteks protokol (MCP). MCP bertindak sebagai cara standar untuk menghubungkan layanan dan kemampuan eksternal (alat) ke Gemini Cli. Dengan mengonfigurasi server MCP, Gemini CLI dapat mengintegrasikan alat-alat eksternal ini dengan mulus ke dalam perintah yang digerakkan oleh AI dan alur kerja penalaran.

- Menyiapkan server MCP:
Anda mulai dengan mengonfigurasi server MCP di file Pengaturan Gemini CLI, biasanya ditemukan di `~/.gemini/settings.json`. File JSON ini mengkonfigurasi server MCP apa yang akan terhubung dengan, termasuk detail koneksi dan otentikasi jika diperlukan.

- Menggunakan server MCP yang ada atau kustom:
Banyak server MCP yang ada berinteraksi dengan layanan populer seperti GitHub, GitLab, Firebase, Database, atau Media Generation. Untuk fungsionalitas yang benar -benar khusus, Anda dapat membuat server MCP Anda sendiri menggunakan MCP SDK yang tersedia dalam bahasa seperti Python atau TypeScript. Ini memungkinkan hosting logika atau alat khusus sebagai server MCP.

- Mengkonfigurasi Server MCP:
Dalam file `settings.json`, server MCP didefinisikan dengan nama mereka, jenis server, perintah koneksi atau URL, token untuk otentikasi, dan parameter khusus. Setelah dikonfigurasi, Gemini CLI akan terhubung ke server ini saat startup.

- Penemuan dan penggunaan alat:
Setelah koneksi, server MCP mengekspos alat yang Gemini Cli secara otomatis menemukan. Anda dapat mendaftar dan menggambarkan alat -alat ini dengan perintah seperti `/mcp` dan`/mcp desc`. Agen AI kemudian mengintegrasikannya secara asli ke dalam aliran pengambilan keputusan dan eksekusi, memilih alat yang diperlukan berdasarkan petunjuk pengguna tanpa intervensi manual.

Membuat ekstensi Gemini Cli

Di luar server MCP, Gemini CLI mendukung konsep tingkat lebih tinggi yang disebut Extensions, yang menggabungkan server MCP, file konteks, dan perintah khusus untuk memperluas fungsionalitas Gemini CLI.

- Lokasi ekstensi:
Ekstensi dapat berada di dua lokasi utama: `/.gemini/ekstensi/` atau `/.gemini/ekstensi/`. Gemini Cli memuat semua ekstensi yang ditemukan di kedua lokasi saat startup, dengan ekstensi khusus ruang kerja yang mengesahkan versi direktori rumah jika konflik nama muncul.

- Struktur ekstensi:
Setiap ekstensi adalah direktori yang dinamai ekstensi (mis., `My-Extension`) yang berisi file konfigurasi bernama` Gemini-Extension.json`. JSON ini mencakup konfigurasi metadata dan server.

- Konten Gemini-Extension.json:
Kunci khas dalam file ini meliputi:

- `Name`: Nama ekstensi unik.
- `Versi`: Versi ekstensi.
- `McPservers`: Peta server MCP yang dikonfigurasi oleh ekstensi, mis., Perintah untuk meluncurkan server MCP khusus.
- `ContextFileName`: Opsional. Nama file konteks dimuat sebagai konteks ruang kerja untuk ekstensi, default ke `gemini.md`.
- `excludetools`: Array menentukan alat atau perintah alat untuk dikecualikan, berguna untuk memblokir operasi berbahaya atau tidak diinginkan.

- Perintah khusus dalam ekstensi:
Ekstensi dapat memberikan perintah slash khusus dengan menempatkan file definisi perintah `.toml` di dalam` perintah/`subdirektori di dalam direktori ekstensi. Perintah ini didefinisikan mirip dengan perintah pengguna atau khusus proyek.

- Perilaku Gabungkan:
Ketika Gemini CLI dimulai, ia menggabungkan konfigurasi ekstensi dengan pengaturan utama pengguna dan alat bawaan, menyelesaikan konflik dengan memberikan prioritas pengaturan ruang kerja.

Membuat perintah slash khusus dengan file toml

Cara fleksibel untuk menambahkan perintah yang dapat digunakan kembali (alat) adalah dengan menggunakan file `.toml` sebagai perintah slash khusus.

- Lokasi:
Masukkan file perintah TOML di `~/.gemini/perintah/` untuk perintah global atau dalam proyek-lokal. Gemini/perintah/`direktori.

- Format Toml:
File -file ini menentukan perintah, templat prompt, dan dapat menggabungkan argumen dengan placeholder seperti ``. Mereka juga mendukung eksekusi perintah shell dalam prompt menggunakan sintaks seperti `! {...}` untuk menanamkan skrip.

- Penggunaan:
Perintah -perintah ini dapat dipanggil secara langsung di Gemini Cli melalui perintah Slash seperti `/MyCommand`, memungkinkan alur kerja atau integrasi yang ditulis dengan mudah.

Menjalankan skrip python khusus dan perintah shell

- Karena Gemini CLI mendukung menjalankan perintah dan skrip shell, Anda dapat memicu skrip Python khusus atau program lain sebagai bagian dari server MCP Anda atau alur kerja perintah khusus.

- Misalnya, skrip Python yang menghasilkan PDF dari tanggapan Gemini CLI dapat dibungkus dalam server MCP atau dieksekusi sebagai perintah shell dalam perintah TOML khusus, memungkinkan alur kerja generasi satu-komandan.

Integrasi dengan IDE dan Lingkungan

- Ekstensi Gemini CLI juga dapat meningkatkan integrasi dengan IDE seperti VS Code dengan berbagi konteks ruang kerja (file, lokasi kursor, pilihan), memungkinkan alur kerja bantuan kode yang digerakkan oleh AI.

- Ekstensi dan server MCP membantu mengintegrasikan alur kerja yang disesuaikan langsung ke lingkungan CLI atau IDE, meningkatkan produktivitas dan fleksibilitas toolchain.

Ringkasan proses untuk menambahkan alat atau ekstensi khusus

1. Tentukan ruang lingkup alat khusus:
Tentukan apakah itu adalah perintah kustom sederhana, skrip, atau layanan eksternal yang lengkap.

2. Untuk perintah khusus sederhana:
Buat file `.toml` mendefinisikan perintah slash dan letakkan di folder perintah yang sesuai.

3. Untuk layanan eksternal atau logika kompleks:
Kembangkan server MCP menggunakan MCP SDK (bahasa pendukung seperti Python atau TypeScript) yang memperlihatkan kemampuan alat melalui API standar.

4. Konfigurasikan server MCP di `settings.json` atau ekstensi:
Tambahkan entri konfigurasi server MCP (dengan perintah atau url) baik secara langsung di konfigurasi pengguna `~/.gemini/settings.json` atau di dalam file` Gemini-Extension.json` dalam direktori ekstensi.

5. Bundel opsional dalam suatu ekstensi:
Kemas server MCP Anda, perintah khusus, dan file konteks ke dalam struktur direktori ekstensi di bawah `.gemini/ekstensi/`.

6. Mulai atau restart Gemini Cli:
Gemini CLI memuat semua konfigurasi dan server MCP saat startup, alat kustom integrasi otomatis.

7. Gunakan dan verifikasi Alat:
Gunakan perintah seperti `/mcp` dan`/mcp desc` untuk mengonfirmasi ketersediaan alat dan berinteraksi dengan penambahan khusus Anda.

Manfaat arsitektur ini

- Modularitas: Alat dijalankan sebagai server MCP terpisah, membuat pengembangan independen dan dapat diskalakan.

- Integrasi Dinamis: Alat muncul secara otomatis dalam alur kerja Gemini CLI tanpa Hardcoding.

- Keamanan dan Kontrol: Ekstensi dapat membatasi alat atau perintah shell mana yang diizinkan, mencegah penyalahgunaan.

- Reusability: Paket ekstensi alur kerja lengkap, dapat dibagikan di seluruh proyek atau tim.

- Komunitas dan Ekosistem: Banyak server dan ekstensi MCP tersedia atau dapat disumbangkan, kemampuan Gemini CLI yang berkembang pesat.

Arsitektur ini memungkinkan hampir semua alat, skrip, atau layanan eksternal untuk diintegrasikan ke dalam ekosistem Gemini Cli, meningkatkan produktivitas dan kustomisasi.

***

Jawaban ini memberikan penjelasan menyeluruh tentang alat kustom Gemini CLI dan mekanisme integrasi ekstensi, termasuk server MCP, kemasan ekstensi, perintah khusus, dan integrasi skrip, memenuhi panjang dan detail yang diminta. Jika diinginkan, lebih spesifik tentang penggunaan MCP SDK atau konfigurasi contoh dapat disediakan berikutnya.