HQbird MCP AI асистент
AI асистент под људском контролом
HQbird MCP повезује Firebird са AI асистентом. Пишете обичним речима, а асистент сам бира алате. Чита слободно. Свака измена чека ваше „да“, а опасна чека одобрење на самом серверу.
- 122 алата
- 56 само за читање
- Firebird 2.5–5 Windows и Linux
- 2 канала за одобрење
- лог ревизије са хеш ланцем
Пример
Разговор са асистентом
Корисници се жале да је база података спора. Асистент чита податке, проналази узрок, предлаже акцију и чека вашу одлуку. Имена и бројеви у примеру су измишљени.
Ради било који MCP клијент: Claude Desktop, Claude Code, Cursor, Codex, ZCode и други.
Политика · одобрење
Четири нивоа опасности
Сваки алат има ниво. MCP сервер сам проверава ниво и услове пре него што се позив изврши. Позив који нешто мења враћа захтев за одобрење, а не резултат. Асистент не може да заобиђе ову проверу.
Изаберите алат и погледајте којим путем иде његов позив.
| Ниво | Алати | Примери | Како се одобрава |
|---|---|---|---|
| 0 · Читање | 51 | сесије, трансакције, план упита, gstat, firebird.log, извештаји агента | Није потребно. Трансакција само за читање. |
| 1 · Измена | 31 | DML и DDL, резервна копија, тестни опоравак, sweep, корисници и дозволе, прекидање сесије | У чету: број захтева и токен, затим fb_confirm. |
| 2 · Опасна операција | 14 | замена базе података из резервне копије, измена firebird.conf, заустављање и поновно покретање Firebird | Само на серверу: команда fbmcp ctl approve. На Windows-у можете инсталирати и прозор у системској траци. |
| 3 · Онемогућено | 1 | брисање базе података | Никада се не извршава. |
- ПрегледСваки алат који захтева одобрење прихвата
mode: preview. Приказује шта ће бити урађено и ништа не ради. - Услови за ниво 2Свака операција нивоа 2 захтева отворен прозор за одржавање на тој бази података. Замена базе података из резервне копије, ексклузивни прозор и опасан SQL такође захтевају проверену резервну копију не старију од 24 сата. Одбијање наводи шта недостаје.
- Само дозвољени алатиКлијент у листи види само оно што му је дозвољено: без нивоа 3 и без нивоа изнад максимума његовог кључа. Директан позив скривеног алата се одбија.
- Захтев живи 15 минутаПокушај одобрења кроз погрешан канал га не троши.
fb_cancelбрише захтев. - Нема странице за одобрењеИ неће је бити: страница до које модел може да дође нарушила би заштиту. Само особа на серверу одобрава: командом
fbmcp ctl approveили у прозору у системској траци, ако је инсталиран.
Читања се извршавају у трансакцији само за читање: сам Firebird блокира уписе. За други слој заштите поставите посебног корисника само за читање без права писања.
Надгледање · резервне копије · дозволе
За DBA
Асистент ради оно што DBA ради ручно: проверава сесије и трансакције, чита логове, прави резервну копију и верификује је опоравком, управља корисницима. Базе података именује по id-у, не по путањи датотеке.
| Задатак | Алати | Ниво |
|---|---|---|
| Да ли све ради | fb_ping, fb_db_list, fb_db_health, fb_service_status | 0 |
| Сесије и дуге трансакције | fb_sessions, fb_transactions; за прекидање сесије — fb_session_kill | 0 · 1 |
| Логови и статистика | fb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends | 0 |
| Резервна копија и верификација | fb_backup_start (gbak), fb_backup_nbackup, fb_restore_test | 1 |
| Старе резервне копије | fb_retention_run: прво пробни рад; брише само проверене резервне копије из сопственог каталога | 1 |
| Sweep и валидација базе података | fb_sweep, fb_validate (само налази, без поправке) | 1 |
| Корисници и дозволе | fb_user_create, fb_grant, fb_revoke; SYSDBA и његови сопствени налози не могу се брисати | 1 |
| Трагови | fb_trace_start само са шаблонима: audit-lite, performance, errors | 1 |
| firebird.conf | fb_config_get, fb_config_diff; за измену — fb_config_set, Firebird се не поново покреће | 0 · 2 |
| Сервис и замена базе података | fb_service_restart; fb_restore_replace, стара датотека остаје као .pre-restore | 2 |
Ноћна провера резервне копије
Распоред се одобрава једном, када се креира. Након тога се извршава без људског присуства. Сваке ноћи добијате проверену резервну копију. Потребна вам је, на пример, да замените базу података из резервне копије.
- 1Распоред
fb_schedule_create, циљnightly_verify; одобрава се једном - 2Резервна копијаgbak у фасциклу за резервне копије
- 3Пробни опораваку радну фасциклу; изворна база података се не дира
- 4✓ Резервна копија проверенаознака у каталогу резервних копија
Замена базе података из резервне копије и операције нивоа 3 не могу се заказати.
Готови сценарији
Сценарији предлажу асистенту редослед корака. Он сам не примењује измене.
Упити · индекси · миграције
За програмере
Асистент у Cursor-у или Claude Code-у познаје вашу шему, проверава упит пре него што се изврши и приказује резултат као табелу директно у чету.
- 1Задатакшта вам је потребно, у једној реченици
- 2Чињенице
fb_schema_list,fb_describe: само постојеће табеле и колоне - 3Нацртједан SELECT са ORDER BY
- 4Провера
fb_query_check: компајлирање без извршавања - 5✓ Табела у чету
fb_query: редови, план и статистика
Резултат као табела
У клијентима који подржавају MCP Apps, резултат fb_query се приказује као табела која се може сортирати. Остали клијенти добијају исте податке као текст.
100 редова подразумевано, највише 1000. Табела остаје у меморији 30 минута, и само особа која ју је затражила може је видети. Кликните на заглавље колоне да сортирате.
SELECT full_name, dept_no, salary FROM employee WHERE salary > 60000 ORDER BY salary DESC
Савет за индексе
Проналази пуне скенирања табеле и предлаже CREATE INDEX са проценом користи. Сам не креира индекс: то чини fb_write, уз одобрење. Након креирања индекса, поново проверава план.
Поређење база података
Шема две базе података, или базе података и њеног снимка: шта креирати, изменити, одбацити. Подаци се пореде по примарном кључу; алат не пореди велику табелу (подразумевано, више од 100.000 редова).
Миграције
План приказује ниво сваке наредбе. Све миграције се примењују након једног одобрења; ако се датотека промени, потребан је нови захтев. План враћања се гради од онога што је забележено приликом примене миграција.
fb_write проналази ниво сваке наредбе у скрипти. Скрипта која меша наредбе различитих нивоа се одбија.
fbagent · Локални API · 127.0.0.1
fbagent подаци
fbagent агент већ ради на HQbird серверу. Преко MCP-а асистент добија све што је агент прикупио: извештај о здрављу, LWM (Light-weight Monitoring), gstat, трагове, застоје, статус резервне копије. Такође извршава послове агента и мења њихова подешавања, под истим нивоима и одобрењима.
| Шта | Алати | Ниво |
|---|---|---|
| Извештај о здрављу сервера | fb_agent_status | 0 |
| LWM, gstat, метрике базе података, трагови, застоји | fb_agent_artifact_get, fb_agent_perf_report | 0 |
| Подешавања резервне копије, sweep-а и опоравка | fb_agent_backup_config; лозинке и токени су скривени | 0 |
| Покрени посао агента | fb_agent_job_run; резервна копија, опоравак и SQL скрипта су ниво 2 | 1 · 2 |
| Промени подешавање посла | fb_agent_config_set; акредитиви, id-јеви и команде не могу се мењати | 2 |
| Поново покрени Firebird преко агента | fb_agent_restart, fb_agent_stop, fb_agent_start | 2 |
| Лиценца и ажурирања | fb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply | 0 · 1 · 2 |
- Само локалноАгент прихвата захтеве само на 127.0.0.1. Адреса агента долази из конфигурације MCP сервера, не из чета.
- Токен остаје скривенТокен агента се не појављује у излазу алата ни у евиденцији ревизије.
- Откривање агента
fb_agent_discoverпроналази агенте на серверу преко Windows сервиса или systemd јединица. Не чита токене. - КластерАко је на серверу инсталиран чвор кластера,
fb_agent_restart,fb_agent_stopиfb_agent_startподразумевано одбијају: чвор контролише поновна покретања.fb_service_restartто не проверава, зато га не користите на чвору кластера.
Двострука контрола. MCP сервер одобрава захтев, а агент сам извршава посао, по својим правилима. MCP дневник показује ко је тражио; дневници агента показују како је то урађено.
HQbird Cluster · RCM
Репликациони кластер кроз асистента
Асистент гради репликациони кластер корак по корак: укључује RCM, отвара прозор за упаривање, повезује домаћине, узима базе података под управљање и прави копију за реплику. Ради кроз агента и RCM. Није потребно да се пријављујете на сервере преко SSH.
Правила су иста као свуда. Читања не захтевају потврду. Промена се потврђује у чету. Поновно покретање Firebird-а, копирање базе на реплику, уклањање сервера из кластера, switchover, failover и повратак старог мастера потврђују се на серверу.
| Шта | Алати | Ниво |
|---|---|---|
| Стање кластера на серверу | fb_agent_cluster: слободан, у кластеру или RCM власник; слот и портови | 0 |
| Преглед кластера у RCM-у | fb_cluster_status: чворови, базе података, команде, упозорења | 0 |
| Провера домаћина пре повезивања | fb_cluster_probe: ред по агенту, отисак сертификата | 0 |
| Упоређивање мастера и реплике | fb_cluster_verify: број редова сваке табеле | 0 |
| Укључивање RCM-а на серверу | fb_agent_cluster_rcm | 1 |
| Прозор за упаривање | fb_agent_cluster_pairing: стање, отворен 1–24 сата, затварање | 0 · 1 |
| Повезивање домаћина | fb_cluster_link; захтев приказује отиске за упоређивање | 1 |
| Базе података и публикација | fb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication | 1 |
| RCM лозинка | fb_cluster_rcm_password: нова насумична лозинка, не приказује се у чету | 1 |
| Копија базе на реплику | fb_cluster_reinit | 2 |
| Поновно покретање Firebird-а чвора | fb_cluster_firebird_restart | 2 |
| Уклањање сервера из кластера | fb_cluster_unlink | 2 |
| Сервиси: где је мастер | fb_cluster_service: мастер, реплике, рутери, проблеми, операција у току | 0 |
| Опис сервиса и његовог правила | fb_cluster_service_put, fb_cluster_service_policy: опис сервиса, правило аутоматског failover-а | 1 |
| Наставак и отказивање операције | fb_cluster_resume, fb_cluster_operation_cancel; отказивање само пре тачке без повратка | 1 |
| Switchover | fb_cluster_switchover: планирано премештање мастера, чека крај операције | 2 |
| Failover | fb_cluster_failover: само уз изричиту сагласност за губитак података | 2 |
| Враћање старог мастера | fb_cluster_rejoin | 2 |
| Брисање сервиса | fb_cluster_service_delete: брише се само запис у RCM-у | 2 |
- Готов сценарио„Направи кластер”: асистент иде корак по корак и на сваком кораку показује шта ће урадити.
- ОтисциПре повезивања, асистент приказује отисак сертификата сваког сервера. Упоредите га са линијом из резимеа инсталације.
- Пробни радПре него што узме фасциклу са базама података под управљање, асистент показује које ће базе података RCM пронаћи.
- Switchover и failoverАсистент покреће премештање мастера и прати кораке операције. Особа на серверу потврђује почетак. Failover такође захтева изричиту сагласност за губитак података. Више на страници кластера.
HTTPS · API кључеви · ревизија
Удаљени режим, инсталација и дневник ревизије
Асистент ради на администраторовом рачунару, а MCP сервер ради на серверу базе података. Између њих су HTTPS и API кључ. Свака особа има свој кључ и свој максимални ниво.
- Кључ за сваку особу
fbmcp ctl apikey new <name> --max-tier 2. Вредност се приказује једном. Након промене кључа, стари кључ престаје да ради у року од неколико секунди. - ОграничењаПо кључу: истовремени позиви, позиви у минути, отворене сесије. Изнад ограничења, одговор је 429.
- Водич на португалскомКомплетан водич за инсталацију и коришћење доступан је и на бразилском португалском.
- Аутономни агентиПрофил
autonomous: подразумевано само читање. Промена чека оператера на серверу;fb_confirmод агента се одбија. 10 позива у минути. Покрените такве агенте унутар компанијске мреже. - АдресеКључ се може везати за адресе (
allow_from). Друга адреса добија 403 и запис у дневнику.
Инсталација у HQbird-у
HQbird инсталатер подразумевано инсталира MCP сервер. Један сервер опслужује све Firebird линије на машини. Једна команда подешава све, и можете је поново покренути.
- 1HQbird инсталатерWindows или Linux
- 2fbmcp ctl hqbird-installједна команда, без ручног уређивања YAML-а
- 3Firebird линијепроналази сваку линију и њен агент
- 4Базе податакаалијаси из databases.conf и недавно повезане базе података
- 5✓ Сервиспокретање, провера, датотека connect.txt за клијенте
Удаљени режим се укључује када су испуњена три услова: подешена је листа администраторских адреса (--allow-from), заштитни зид ради и постоји најмање један API кључ. Кључ креирате одвојено. Након тога поново покрените fbmcp ctl hqbird-install. Подразумевани порт је 8650.
Хеш ланац
Свака одлука (одобрено, на чекању, прихваћено, одбијено) се уписује у дневник. Сваки унос је повезан са претходним. Провера ланца показује да ли је неки унос измењен или избрисан.
Дневник скраћен — сервер остаје искључен
Ако је дневник скраћен или његов крај не одговара контролном уносу, MCP сервер се не покреће. То је знак неовлашћеног мешања и морате га истражити. Команда fbmcp ctl verify проверава цео ланац.
Преко агента
fbagent ажурира MCP сервер: заустави, замени, покрени, провери, врати на претходно стање у случају неуспеха. На Linux-у се неинсталира потписана верзија. Конфигурација и кључеви се не мењају.