HQbird MCP AI asistanı
İnsan kontrolü altında AI asistanı
HQbird MCP, Firebird'ü bir AI asistanına bağlar. Siz sade bir dille yazarsınız, asistan araçları kendisi seçer. Serbestçe okur. Her değişiklik sizin "evet"inizi bekler, tehlikeli olan ise sunucunun kendisinde onay bekler.
- 122 araç
- 56 salt okunur
- Firebird 2.5–5 Windows ve Linux
- 2 kanal onay için
- denetim günlüğü hash zinciriyle
Örnek
Asistanla bir konuşma
Kullanıcılar veritabanının yavaş olduğundan şikayet ediyor. Asistan verileri okur, nedeni bulur, bir eylem önerir ve sizin kararınızı bekler. Örnekteki adlar ve sayılar uydurmadır.
Herhangi bir MCP istemcisi çalışır: Claude Desktop, Claude Code, Cursor, Codex, ZCode ve diğerleri.
Politika · onay
Dört tehlike seviyesi
Her aracın bir seviyesi vardır. MCP sunucusu, çağrı çalışmadan önce seviyeyi ve koşulları kendisi kontrol eder. Bir şeyi değiştiren çağrı, sonuç yerine bir onay isteği döndürür. Asistan bu kontrolü atlayamaz.
Bir araç seçin ve çağrısının hangi yolu izlediğini görün.
| Seviye | Araçlar | Örnekler | Nasıl onaylanır |
|---|---|---|---|
| 0 · Okuma | 51 | oturumlar, işlemler, sorgu planı, gstat, firebird.log, agent raporları | Gerekmez. Salt okunur işlem. |
| 1 · Değişiklik | 31 | DML ve DDL, yedekleme, test geri yükleme, sweep, kullanıcılar ve yetkiler, bir oturumu sonlandırma | Sohbette: istek numarası ve token, ardından fb_confirm. |
| 2 · Tehlikeli işlem | 14 | bir veritabanını yedekten değiştirme, firebird.conf düzenleme, Firebird'ü durdurma ve yeniden başlatma | Yalnızca sunucuda: fbmcp ctl approve komutu. Windows'ta ayrıca bir tepsi penceresi kurabilirsiniz. |
| 3 · Devre dışı | 1 | bir veritabanını silme | Asla çalışmaz. |
- ÖnizlemeOnay gerektiren her araç
mode: previewkabul eder. Ne yapılacağını gösterir ve hiçbir şey yapmaz. - Seviye 2 koşullarıHer seviye 2 işlemi, o veritabanında açık bir bakım penceresi gerektirir. Bir veritabanını yedekten değiştirme, özel bir pencere ve tehlikeli SQL ayrıca 24 saatten eski olmayan doğrulanmış bir yedek gerektirir. Bir ret, neyin eksik olduğunu söyler.
- Yalnızca izin verilen araçlarİstemci listede yalnızca kullanmasına izin verilenleri görür: seviye 3 yok ve anahtarının maksimumunun üzerindeki seviyeler yok. Gizli bir araca doğrudan çağrı reddedilir.
- Bir istek 15 dakika yaşarYanlış kanaldan onaylama girişimi onu tüketmez.
fb_cancelisteği siler. - Onay sayfası yokVe olmayacak: modelin erişebileceği bir sayfa korumayı bozar. Yalnızca sunucudaki bir kişi onaylar:
fbmcp ctl approvekomutuyla veya kuruluysa tepsi penceresinde.
Okumalar salt okunur bir işlemde çalışır: yazmaları Firebird'ün kendisi engeller. İkinci bir koruma katmanı için yazma hakkı olmayan ayrı bir salt okunur kullanıcı ayarlayın.
İzleme · yedeklemeler · yetkiler
DBA'lar için
Asistan, bir DBA'nın elle yaptığını yapar: oturumları ve işlemleri kontrol eder, günlükleri okur, yedek alır ve geri yüklemeyle doğrular, kullanıcıları yönetir. Veritabanlarını dosya yoluyla değil, kimlikle adlandırır.
| Görev | Araçlar | Seviye |
|---|---|---|
| Her şey çalışıyor mu | fb_ping, fb_db_list, fb_db_health, fb_service_status | 0 |
| Oturumlar ve uzun işlemler | fb_sessions, fb_transactions; bir oturumu sonlandırmak için — fb_session_kill | 0 · 1 |
| Günlükler ve istatistikler | fb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends | 0 |
| Yedekleme ve doğrulama | fb_backup_start (gbak), fb_backup_nbackup, fb_restore_test | 1 |
| Eski yedekler | fb_retention_run: önce deneme çalıştırması; yalnızca kendi kataloğundaki doğrulanmış yedekleri siler | 1 |
| Sweep ve veritabanı doğrulama | fb_sweep, fb_validate (yalnızca bulgular, onarım yok) | 1 |
| Kullanıcılar ve yetkiler | fb_user_create, fb_grant, fb_revoke; SYSDBA ve kendi hesapları silinemez | 1 |
| İzlemeler | fb_trace_start yalnızca şablonlarla: audit-lite, performance, errors | 1 |
| firebird.conf | fb_config_get, fb_config_diff; düzenlemek için — fb_config_set, Firebird yeniden başlatılmaz | 0 · 2 |
| Hizmet ve veritabanı değiştirme | fb_service_restart; fb_restore_replace, eski dosya .pre-restore olarak kalır | 2 |
Gece yedekleme kontrolü
Zamanlama, oluşturulduğunda bir kez onaylanır. Bundan sonra bir kişi olmadan çalışır. Her gece doğrulanmış bir yedek alırsınız. Örneğin, bir veritabanını yedekten değiştirmek için buna ihtiyacınız olur.
- 1Zamanlama
fb_schedule_create, hedefnightly_verify; bir kez onaylanır - 2Yedeklemeyedek klasörüne gbak
- 3Test geri yüklemebir çalışma klasörüne; kaynak veritabanına dokunulmaz
- 4✓ Yedek doğrulandıyedek kataloğunda bir işaret
Yedekten veritabanı değiştirme ve seviye 3 işlemleri zamanlanamaz.
Hazır senaryolar
Senaryolar asistana adımların sırasını önerir. Değişiklikleri kendisi uygulamaz.
Sorgular · dizinler · geçişler
Geliştiriciler için
Cursor veya Claude Code'daki asistan şemanızı bilir, bir sorguyu çalışmadan önce kontrol eder ve sonucu doğrudan sohbette tablo olarak gösterir.
- 1Görevihtiyacınız olan şey, tek bir cümleyle
- 2Gerçekler
fb_schema_list,fb_describe: yalnızca mevcut tablolar ve sütunlar - 3TaslakORDER BY içeren tek bir SELECT
- 4Kontrol
fb_query_check: çalıştırmadan derle - 5✓ Sohbette tablo
fb_query: satırlar, plan ve istatistikler
Sonuç tablo olarak
MCP Apps destekleyen istemcilerde fb_query sonucu sıralanabilir bir tablo olarak gösterilir. Diğer istemciler aynı verileri metin olarak alır.
Varsayılan olarak 100 satır, en fazla 1000. Tablo 30 dakika boyunca bellekte kalır ve yalnızca onu isteyen kişi görebilir. Sıralamak için bir sütun başlığına tıklayın.
SELECT full_name, dept_no, salary FROM employee WHERE salary > 60000 ORDER BY salary DESC
Dizin önerisi
Tam tablo taramalarını bulur ve CREATE INDEX önerir, sağlayacağı faydayı tahmin eder. Dizini kendisi oluşturmaz: bunu onayla birlikte fb_write yapar. Dizin oluşturulduktan sonra planı yeniden kontrol eder.
Veritabanı karşılaştırma
İki veritabanının ya da bir veritabanı ile anlık görüntüsünün şeması: neyin oluşturulacağı, değiştirileceği, kaldırılacağı. Veriler birincil anahtara göre karşılaştırılır; araç büyük bir tabloyu (varsayılan olarak 100.000 satırdan fazla) karşılaştırmaz.
Migration Framework
Plan, her ifadenin seviyesini gösterir. Tüm migration'lar tek bir onaydan sonra uygulanır; bir dosya değişirse yeni bir talep gerekir. Geri alma planı, migration'lar uygulanırken kaydedilenlerden oluşturulur.
fb_write bir betikteki her ifadenin seviyesini bulur. Farklı seviyelerdeki ifadeleri karıştıran bir betik reddedilir.
fbagent · Yerel API · 127.0.0.1
fbagent verileri
fbagent aracısı HQbird sunucusunda zaten çalışıyor. Asistan MCP aracılığıyla aracının topladığı her şeye erişir: sağlık raporu, LWM (Light-weight Monitoring), gstat, trace'ler, deadlock'lar, yedekleme durumu. Ayrıca aracı işlerini çalıştırır ve ayarlarını değiştirir; aynı seviyeler ve onaylar altında.
| Ne | Araçlar | Seviye |
|---|---|---|
| Sunucu sağlık raporu | fb_agent_status | 0 |
| LWM, gstat, veritabanı metrikleri, trace'ler, deadlock'lar | fb_agent_artifact_get, fb_agent_perf_report | 0 |
| Yedekleme, sweep ve geri yükleme ayarları | fb_agent_backup_config; parolalar ve token'lar gizlenir | 0 |
| Aracı işi çalıştır | fb_agent_job_run; yedekleme, geri yükleme ve SQL betiği seviye 2'dir | 1 · 2 |
| İş ayarını değiştir | fb_agent_config_set; kimlik bilgileri, id'ler ve komutlar değiştirilemez | 2 |
| Aracı üzerinden Firebird'ü yeniden başlat | fb_agent_restart, fb_agent_stop, fb_agent_start | 2 |
| Lisans ve güncellemeler | fb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply | 0 · 1 · 2 |
- Yalnızca yerelAracı istekleri yalnızca 127.0.0.1 üzerinde kabul eder. Aracı adresi sohbetten değil, MCP sunucusu yapılandırmasından gelir.
- Token gizli kalırAracı token'ı araç çıktısında veya denetim günlüğünde görünmez.
- Aracı keşfi
fb_agent_discoversunucudaki aracıları Windows servisleri veya systemd birimleriyle bulur. Token'ları okumaz. - KümeSunucuda bir küme düğümü kuruluysa
fb_agent_restart,fb_agent_stopvefb_agent_startvarsayılan olarak reddeder: yeniden başlatmaları düğüm kontrol eder.fb_service_restartbunu kontrol etmez, bu yüzden bir küme düğümünde kullanmayın.
Çift kontrol. MCP sunucusu talebi onaylar ve aracının kendisi işi kendi kurallarına göre çalıştırır. MCP günlüğü kimin istediğini gösterir; aracı günlükleri nasıl yapıldığını gösterir.
HQbird Cluster · RCM
Asistan aracılığıyla replikasyon kümesi
Asistan bir replikasyon kümesini adım adım kurar: RCM'yi açar, eşleştirme penceresini açar, ana bilgisayarları bağlar, veritabanlarını yönetim altına alır ve replika için bir kopya oluşturur. Aracı ve RCM üzerinden çalışır. Sunuculara SSH ile giriş yapmanız gerekmez.
Kurallar her yerdekiyle aynıdır. Okumalar onay gerektirmez. Bir değişiklik sohbette onaylanır. Firebird'ün yeniden başlatılması, veritabanının replikaya kopyalanması, bir sunucunun kümeden çıkarılması, switchover, failover ve eski master'ın geri dönüşü sunucuda onaylanır.
| Ne | Araçlar | Seviye |
|---|---|---|
| Sunucudaki küme durumu | fb_agent_cluster: boş, bir kümede veya RCM sahibi; slot ve portlar | 0 |
| RCM'de küme genel görünümü | fb_cluster_status: düğümler, veritabanları, komutlar, uyarılar | 0 |
| Bağlamadan önce ana bilgisayarları kontrol et | fb_cluster_probe: aracı başına bir satır, sertifika parmak izi | 0 |
| Master ve replikayı karşılaştır | fb_cluster_verify: her tablonun satır sayısı | 0 |
| Sunucuda RCM'yi aç | fb_agent_cluster_rcm | 1 |
| Eşleştirme penceresi | fb_agent_cluster_pairing: durum, 1–24 saat açık, kapat | 0 · 1 |
| Ana bilgisayarları bağla | fb_cluster_link; talep karşılaştırılacak parmak izlerini gösterir | 1 |
| Veritabanları ve yayın | fb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication | 1 |
| RCM parolası | fb_cluster_rcm_password: yeni rastgele parola, sohbette gösterilmez | 1 |
| Veritabanının replikaya kopyalanması | fb_cluster_reinit | 2 |
| Bir düğümün Firebird'ünü yeniden başlat | fb_cluster_firebird_restart | 2 |
| Bir sunucuyu kümeden çıkar | fb_cluster_unlink | 2 |
| Servisler: master nerede | fb_cluster_service: master, replikalar, yönlendiriciler, sorunlar, çalışan işlem | 0 |
| Bir servisi ve kuralını tanımla | fb_cluster_service_put, fb_cluster_service_policy: servis açıklaması, otomatik failover kuralı | 1 |
| Bir işlemi sürdür ve iptal et | fb_cluster_resume, fb_cluster_operation_cancel; yalnızca geri dönüşü olmayan noktadan önce iptal et | 1 |
| Switchover | fb_cluster_switchover: master'ın planlı taşınması, işlemin bitmesini bekler | 2 |
| Failover | fb_cluster_failover: yalnızca veri kaybına açık rıza ile | 2 |
| Eski master'ı geri getir | fb_cluster_rejoin | 2 |
| Bir servisi sil | fb_cluster_service_delete: yalnızca RCM'deki kayıt silinir | 2 |
- Hazır senaryo“Küme kur”: asistan adım adım ilerler ve her adımda ne yapacağını gösterir.
- Parmak izleriBağlamadan önce asistan her sunucunun sertifika parmak izini gösterir. Bunu kurulum özetindeki satırla karşılaştırın.
- Deneme çalıştırmasıVeritabanları içeren bir klasörü yönetim altına almadan önce asistan RCM'nin hangi veritabanlarını bulacağını gösterir.
- Switchover ve failoverAsistan master'ın taşınmasını başlatır ve işlemin adımlarını izler. Başlatmayı sunucudaki bir kişi onaylar. Failover ayrıca veri kaybına açık rıza gerektirir. Küme sayfasında daha fazlası.
HTTPS · API anahtarları · denetim
Uzak mod, kurulum ve denetim günlüğü
Asistan yöneticinin bilgisayarında, MCP sunucusu ise veritabanı sunucusunda çalışır. Aralarında HTTPS ve bir API anahtarı vardır. Her kişinin kendi anahtarı ve kendi maksimum seviyesi vardır.
- Her kişi için bir anahtar
fbmcp ctl apikey new <name> --max-tier 2. Değer bir kez gösterilir. Bir anahtar değiştikten sonra eski anahtar birkaç saniye içinde çalışmayı durdurur. - LimitlerAnahtar başına: eşzamanlı çağrılar, dakika başına çağrılar, açık oturumlar. Limitin üzerinde yanıt 429'dur.
- Portekizce kılavuzKurulum ve kullanım için tam kılavuz Brezilya Portekizcesi olarak da mevcuttur.
- Otonom aracılar
autonomousprofili: varsayılan olarak yalnızca okuma. Bir değişiklik sunucudaki bir operatörü bekler; aracıdan gelenfb_confirmreddedilir. Dakikada 10 çağrı. Bu tür aracıları şirket ağı içinde çalıştırın. - AdreslerBir anahtar adreslere bağlanabilir (
allow_from). Başka bir adres 403 ve günlüğe bir kayıt alır.
HQbird'de kurulum
HQbird yükleyicisi MCP sunucusunu varsayılan olarak kurar. Tek bir sunucu makinedeki tüm Firebird hatlarına hizmet eder. Tek bir komut her şeyi ayarlar ve komutu yeniden çalıştırabilirsiniz.
- 1HQbird yükleyicisiWindows veya Linux
- 2fbmcp ctl hqbird-installtek komut, elle YAML düzenlemesi yok
- 3Firebird hatlarıher hattı ve aracısını bulur
- 4Veritabanlarıdatabases.conf takma adları ve son bağlanan veritabanları
- 5✓ Servisistemciler için start, check, connect.txt dosyası
Uzak mod üç koşul sağlandığında etkinleşir: bir yönetici adresleri listesi ayarlanmış (--allow-from), güvenlik duvarı çalışıyor ve en az bir API anahtarı mevcut. Anahtarı ayrıca oluşturursunuz. Ardından fbmcp ctl hqbird-install komutunu tekrar çalıştırın. Varsayılan port 8650'dir.
Hash zinciri
Her karar (izin verildi, beklemede, onaylandı, reddedildi) günlüğe yazılır. Her giriş bir öncekine bağlanır. Bir zincir kontrolü, bir girişin değiştirilip değiştirilmediğini veya silinip silinmediğini gösterir.
Günlük kesildi — sunucu kapalı kalır
Günlük kesilmişse veya sonu kontrol girişiyle eşleşmiyorsa, MCP sunucusu başlamaz. Bu bir kurcalama işaretidir ve araştırmanız gerekir. fbmcp ctl verify komutu tüm zinciri kontrol eder.
Aracı üzerinden
fbagent, MCP sunucusunu günceller: durdur, değiştir, başlat, kontrol et, hata durumunda geri al. Linux'ta imzasız bir derleme kurulmaz. Yapılandırma ve anahtarlar değişmez.