Gemini Cli'ye nasıl özel araçlar veya uzantılar ekleyebilirim

Gemini Cli'yi MCP aracılığıyla özel araçlarla genişletme

Gemini CLI, model bağlam protokolü (MCP) aracılığıyla genişletilebilir olacak şekilde tasarlanmıştır. MCP, harici hizmetleri ve yetenekleri (araçlar) Gemini CLI'ye bağlamak için standart bir yol görevi görür. MCP sunucularını yapılandırarak Gemini CLI, bu harici araçları AI güdümlü komutuna ve akıl yürütme iş akışına sorunsuz bir şekilde entegre edebilir.

- MCP sunucularını ayarlama:
MCP sunucularını, genellikle ~/.gemini/sacess.json`'da bulunan Gemini CLI ayarları dosyasında yapılandırarak başlarsınız. Bu JSON dosyası, gerekirse bağlantı detayları ve kimlik doğrulaması dahil olmak üzere MCP sunucularının birbirine bağlanacakları hangi ile bağlantı kuracağını yapılandırır.

- Mevcut veya özel MCP sunucularını kullanmak:
Mevcut birçok MCP sunucusu GitHub, GitLab, Firebase, Veritabanları veya Medya Üretimi gibi popüler hizmetlerle arayüz oluşturur. Gerçekten özel işlevsellik için, Python veya TypeScript gibi dillerde bulunan MCP SDK'yı kullanarak kendi MCP sunucularınızı oluşturabilirsiniz. Bu, herhangi bir özel mantık veya aracı MCP sunucusu olarak barındırmaya izin verir.

- MCP sunucularını yapılandırma:
`Setts.json` dosyasında, MCP sunucuları adları, sunucu türleri, bağlantı komutları veya URL'leri, kimlik doğrulama için jetonlar ve özel parametrelerle tanımlanır. Yapılandırıldıktan sonra Gemini CLI, Startup'ta bu sunuculara bağlanacaktır.

- Araçların keşfi ve kullanımı:
Bağlantıdan sonra, MCP sunucuları Gemini CLI'nin otomatik olarak keşfettiği araçları ortaya çıkarır. Bu araçları `/mcp` ve`/mcp desc 'gibi komutlarla listeleyebilir ve tanımlayabilirsiniz. AI ajanı daha sonra bunları doğal olarak karar verme ve yürütme akışına entegre ederek, manuel müdahale olmadan kullanıcı istemlerine göre gerektiğinde araçları seçer.

Gemini Cli Uzantıları Oluşturma

MCP sunucularının ötesinde, Gemini CLI, Gemini CLI işlevselliğini genişletmek için MCP sunucularını, bağlam dosyalarını ve özel komutları bir araya getiren uzantılar adı verilen üst düzey bir konsepti destekler.

- Uzatma yeri:
Uzantılar iki temel yerde bulunabilir: `/.gemini/uzantıları/` veya `/.gemini/uzantıları/`. Gemini CLI, başlangıçta her iki konumda bulunan tüm uzantıları yükler ve isim çatışmaları ortaya çıkarsa, çalışma alanına özgü uzantılar ev dizin sürümlerini geçersiz kılar.

- Uzatma yapısı:
Her uzantı, `Gemini-Extension.json` adlı bir yapılandırma dosyası içeren uzantıdan (örneğin,` `my-ekstansiyon ') adlandırılan bir dizindir. Bu JSON meta veri ve sunucu yapılandırmalarını içerir.

- Gemini-Extension.json İçeriği:
Bu dosyadaki tipik anahtarlar şunları içerir:

- `name`: benzersiz uzantı adı.
- `sürüm`: Uzantı sürümü.
- `McPservers`: Uzantı tarafından yapılandırılan MCP sunucularının haritası, örneğin özel MCP sunucularını başlatma komutları.
- `contextFilename`: isteğe bağlı. Uzatma için çalışma alanı bağlamı olarak yüklenen bağlam dosyasının adı, varsayılan olarak `gemini.md`.
- `` hariç tutkunlar '': Tehlikeli veya istenmeyen işlemleri engellemek için kullanışlı, hariç tutulacak araçları veya araç komutlarını belirleme.

- Uzantılardaki özel komutlar:
Uzantılar, uzantı dizinine bir `komut/` `alt dizinine` .toml` komut tanımı dosyalarını yerleştirerek özel eğik çizgi komutları sağlayabilir. Bu komutlar kullanıcı veya projeye özgü komutlara benzer şekilde tanımlanır.

- Birleştirme davranışı:
Gemini CLI başladığında, uzatma yapılandırmalarını kullanıcının ana ayarları ve yerleşik araçlarıyla birleştirerek, çalışma alanı ayarlarına öncelik vererek çatışmaları çözer.

Toml dosyalarıyla özel eğik çizgi komutları oluşturmak

Yeniden kullanılabilir komutlar (araçlar) eklemenin esnek bir yolu, özel eğik çizgi komutları olarak `.toml` dosyalarını kullanmaktır.

- Konum:
Toml komut dosyalarını global komutlar için veya proje-local `.gemini/commands/` dizinine `~/.gemini/command/` içine koyun.

- Toml Biçimi:
Bu dosyalar komutu tanımlar, hızlı şablonlar ve ` 'gibi yer tutucularla argümanları dahil edebilir. Ayrıca, komut dosyasını gömmek için `! {...} 'gibi sözdizimini kullanarak Shell komutu yürütmesini destekler.

- Kullanım:
Bu komutlar, "/mycommand" gibi eğik komutlar aracılığıyla doğrudan Gemini CLI'ye çağrılabilir ve komut dosyası iş akışlarını veya entegrasyonları kolayca etkinleştirir.

Özel Python komut dosyalarını ve kabuk komutlarını çalıştırmak

- Gemini CLI kabuk komutlarını ve komut dosyalarını desteklediğinden, MCP sunucunuzun veya özel komut iş akışlarınızın bir parçası olarak özel python komut dosyalarını veya diğer programları tetikleyebilirsiniz.

- Örneğin, Gemini CLI yanıtlarından PDF'ler üreten bir Python betiği, bir MCP sunucusuna sarılabilir veya özel bir toml komutunda bir kabuk komutu olarak yürütülebilir ve bir komut üretim iş akışlarını etkinleştirebilir.

IDES ve Çevre ile Entegrasyon

- Gemini CLI uzantıları, AI güdümlü kod yardımı iş akışlarını etkinleştirerek çalışma alanı bağlamını (dosyalar, imleç konumu, seçimler) paylaşarak vs kod gibi IDE'lerle entegrasyonu da artırabilir.

- Uzantılar ve MCP sunucuları, özel iş akışlarını doğrudan CLI veya IDE ortamına entegre etmeye yardımcı olarak verimliliği ve araç zinciri esnekliğini artırmaya yardımcı olur.

Özel araçlar veya uzantılar ekleme işleminin özeti

1. Özel aracın kapsamına karar verin:
Basit bir özel komut, komut dosyası mı yoksa tam teşekküllü bir harici hizmet olup olmadığını belirleyin.

2. Basit özel komutlar için:
Slash komutlarını tanımlayan `.toml` dosyaları oluşturun ve bunları uygun komutlar klasörüne yerleştirin.

3. Harici hizmetler veya karmaşık mantık için:
Standart API aracılığıyla araç özelliklerini ortaya çıkaran MCP SDK'yı (Python veya TypeScript gibi destekleyici diller) kullanarak bir MCP sunucusu geliştirin.

4. MCP sunucusunu `settings.json` veya uzantısında yapılandırın:
MCP sunucusu yapılandırma girişini (komut veya url ile) doğrudan kullanıcı yapılandırmasına `~/.gemini/settings.json` veya bir uzantı dizinindeki bir` gemini-özü.json` dosyasına ekleyin.

5. İsteğe bağlı olarak bir uzatmada paketleyin:
MCP sunucularınızı, özel komutlarınızı ve bağlam dosyalarınızı `.gemini/extensions/` altındaki bir uzantı dizin yapısına yerleştirin.

6. Gemini CLI'yi başlatın veya yeniden başlatın:
Gemini CLI, başlangıçta tüm yapılandırmaları ve MCP sunucularını yükler, otomatik entegre özel araçlar.

7. Araçları kullanın ve doğrulayın:
Araç kullanılabilirliğini onaylamak ve özel eklemelerinizle etkileşim kurmak için `/mcp` ve`/mcp desc 'gibi komutları kullanın.

Bu mimarinin faydaları

- Modülerlik: Araçlar ayrı MCP sunucuları olarak çalışır, gelişimi bağımsız ve ölçeklenebilir hale getirir.

- Dinamik entegrasyon: Araçlar, Gemini Cli iş akışlarında otomatik olarak görünür.

- Güvenlik ve Kontrol: Uzantılar, hangi araçların veya kabuk komutlarına izin verildiğini sınırlayarak kötüye kullanımı önleyebilir.

- Yeniden Kullanılabilirlik: Uzantılar Paketi Tam iş akışları, projeler veya ekipler arasında paylaşılabilir.

- Topluluk ve Ekosistem: Birçok MCP sunucusu ve uzantısı mevcuttur veya hızla genişleyen İkizler CLI yeteneklerini sunabilir veya katkıda bulunabilir.

Bu mimari, neredeyse her harici araç, komut dosyası veya hizmetinin Gemini CLI ekosistemine entegre edilmesini, verimliliği ve özelleştirmeyi artırmasını sağlar.

***

Bu cevap, Gemini CLI özel aracı ve MCP sunucuları, uzatma ambalajı, özel komutlar ve komut dosyası entegrasyonu dahil olmak üzere, istenen uzunluğu ve detayları karşılayan uzatma entegrasyon mekanizmalarının kapsamlı bir açıklamasını sunar. İstenirse, daha sonra MCP SDK kullanımı veya örnek konfigürasyonlar hakkında daha fazla bilgi verilebilir.