Trợ lý AI HQbird MCP
Trợ lý AI dưới sự kiểm soát của con người
HQbird MCP kết nối Firebird với một trợ lý AI. Bạn viết bằng ngôn ngữ thông thường, và trợ lý tự chọn công cụ. Nó đọc thoải mái. Mỗi thay đổi đều chờ câu “đồng ý” của bạn, và một thay đổi nguy hiểm sẽ chờ phê duyệt ngay trên chính máy chủ.
- 122 công cụ
- 56 chỉ đọc
- Firebird 2.5–5 Windows và Linux
- 2 kênh để phê duyệt
- nhật ký kiểm toán với chuỗi băm
Ví dụ
Một cuộc hội thoại với trợ lý
Người dùng phàn nàn rằng cơ sở dữ liệu chậm. Trợ lý đọc dữ liệu, tìm ra nguyên nhân, đề xuất hành động và chờ quyết định của bạn. Tên và con số trong ví dụ là hư cấu.
Bất kỳ ứng dụng khách MCP nào cũng hoạt động: Claude Desktop, Claude Code, Cursor, Codex, ZCode và những ứng dụng khác.
Chính sách · phê duyệt
Bốn mức độ nguy hiểm
Mỗi công cụ có một cấp độ. Máy chủ MCP tự kiểm tra cấp độ và các điều kiện trước khi lệnh gọi chạy. Một lệnh gọi thay đổi điều gì đó sẽ trả về yêu cầu phê duyệt, chứ không phải kết quả. Trợ lý không thể vượt qua bước kiểm tra này.
Chọn một công cụ và xem lệnh gọi của nó đi theo đường nào.
| Cấp độ | Công cụ | Ví dụ | Cách phê duyệt |
|---|---|---|---|
| 0 · Đọc | 51 | phiên, giao dịch, kế hoạch truy vấn, gstat, firebird.log, báo cáo agent | Không cần. Giao dịch chỉ đọc. |
| 1 · Thay đổi | 31 | DML và DDL, sao lưu, khôi phục thử, sweep, người dùng và quyền, kết thúc một phiên | Trong chat: số yêu cầu và token, sau đó fb_confirm. |
| 2 · Thao tác nguy hiểm | 14 | thay thế cơ sở dữ liệu từ bản sao lưu, sửa firebird.conf, dừng và khởi động lại Firebird | Chỉ trên máy chủ: lệnh fbmcp ctl approve. Trên Windows bạn cũng có thể cài cửa sổ khay hệ thống. |
| 3 · Bị vô hiệu hóa | 1 | xóa cơ sở dữ liệu | Không bao giờ chạy. |
- Xem trướcMỗi công cụ cần phê duyệt đều chấp nhận
mode: preview. Nó cho thấy điều gì sẽ được làm và không làm gì cả. - Điều kiện cho cấp độ 2Mỗi thao tác cấp độ 2 cần một cửa sổ bảo trì đang mở trên cơ sở dữ liệu đó. Thay thế cơ sở dữ liệu từ bản sao lưu, cửa sổ độc quyền và SQL nguy hiểm cũng cần một bản sao lưu đã được xác minh không quá 24 giờ. Một lần từ chối sẽ nói rõ điều gì còn thiếu.
- Chỉ các công cụ được phépỨng dụng khách chỉ thấy trong danh sách những gì nó được phép dùng: không có cấp độ 3 và không có cấp độ cao hơn mức tối đa của khóa của nó. Một lệnh gọi trực tiếp đến công cụ bị ẩn sẽ bị từ chối.
- Một yêu cầu tồn tại 15 phútMột lần cố phê duyệt qua sai kênh không làm mất hiệu lực của nó.
fb_cancelxóa yêu cầu. - Không có trang phê duyệtVà sẽ không có: một trang mà mô hình có thể truy cập sẽ phá vỡ lớp bảo vệ. Chỉ một người trên máy chủ phê duyệt: bằng lệnh
fbmcp ctl approvehoặc trong cửa sổ khay hệ thống, nếu đã cài đặt.
Các thao tác đọc chạy trong một giao dịch chỉ đọc: chính Firebird chặn ghi. Để có thêm một lớp bảo vệ, hãy đặt một người dùng chỉ đọc riêng không có quyền ghi.
Giám sát · sao lưu · quyền
Dành cho DBA
Trợ lý làm những việc mà một DBA làm bằng tay: kiểm tra phiên và giao dịch, đọc nhật ký, tạo bản sao lưu và xác minh nó bằng một lần khôi phục, quản lý người dùng. Nó gọi tên cơ sở dữ liệu bằng id, không phải bằng đường dẫn tệp.
| Nhiệm vụ | Công cụ | Cấp độ |
|---|---|---|
| Mọi thứ có đang hoạt động không | fb_ping, fb_db_list, fb_db_health, fb_service_status | 0 |
| Phiên và giao dịch dài | fb_sessions, fb_transactions; để kết thúc một phiên — fb_session_kill | 0 · 1 |
| Nhật ký và thống kê | fb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends | 0 |
| Sao lưu và xác minh | fb_backup_start (gbak), fb_backup_nbackup, fb_restore_test | 1 |
| Bản sao lưu cũ | fb_retention_run: chạy thử trước; chỉ xóa các bản sao lưu đã được xác minh từ danh mục của chính nó | 1 |
| Sweep và kiểm tra cơ sở dữ liệu | fb_sweep, fb_validate (chỉ phát hiện, không sửa chữa) | 1 |
| Người dùng và quyền | fb_user_create, fb_grant, fb_revoke; SYSDBA và các tài khoản riêng của nó không thể bị xóa | 1 |
| Trace | fb_trace_start chỉ với các mẫu: audit-lite, performance, errors | 1 |
| firebird.conf | fb_config_get, fb_config_diff; để sửa — fb_config_set, Firebird không được khởi động lại | 0 · 2 |
| Dịch vụ và thay thế cơ sở dữ liệu | fb_service_restart; fb_restore_replace, tệp cũ được giữ lại dưới dạng .pre-restore | 2 |
Kiểm tra sao lưu hằng đêm
Lịch được phê duyệt một lần, khi nó được tạo. Sau đó nó chạy mà không cần người. Mỗi đêm bạn nhận được một bản sao lưu đã được xác minh. Bạn cần một bản, ví dụ, để thay thế cơ sở dữ liệu từ bản sao lưu.
- 1Lịch
fb_schedule_create, mục tiêunightly_verify; được phê duyệt một lần - 2Sao lưugbak vào thư mục sao lưu
- 3Khôi phục thửvào một thư mục làm việc; cơ sở dữ liệu nguồn không bị động đến
- 4✓ Bản sao lưu đã xác minhmột dấu trong danh mục sao lưu
Thay thế cơ sở dữ liệu từ bản sao lưu và các thao tác cấp độ 3 không thể được lên lịch.
Các kịch bản có sẵn
Các kịch bản gợi ý thứ tự các bước cho trợ lý. Nó không tự áp dụng thay đổi.
Truy vấn · chỉ mục · di trú
Dành cho lập trình viên
Trợ lý trong Cursor hoặc Claude Code biết lược đồ của bạn, kiểm tra một truy vấn trước khi nó chạy và hiển thị kết quả dưới dạng bảng ngay trong chat.
- 1Nhiệm vụđiều bạn cần, trong một câu
- 2Sự thật
fb_schema_list,fb_describe: chỉ các bảng và cột tồn tại - 3Bản nhápmột SELECT với ORDER BY
- 4Kiểm tra
fb_query_check: biên dịch mà không chạy - 5✓ Bảng trong chat
fb_query: các hàng, kế hoạch và thống kê
Kết quả dưới dạng bảng
Trong các ứng dụng khách hỗ trợ MCP Apps, kết quả của fb_query được hiển thị dưới dạng bảng có thể sắp xếp. Các ứng dụng khách khác nhận cùng dữ liệu dưới dạng văn bản.
Mặc định 100 hàng, tối đa 1000. Bảng được giữ trong bộ nhớ 30 phút, và chỉ người đã yêu cầu nó mới có thể xem. Nhấp vào tiêu đề cột để sắp xếp.
SELECT full_name, dept_no, salary FROM employee WHERE salary > 60000 ORDER BY salary DESC
Tư vấn chỉ mục
Tìm các lần quét toàn bảng và đề xuất CREATE INDEX kèm ước tính lợi ích. Công cụ không tự tạo chỉ mục: fb_write làm việc đó, sau khi được phê duyệt. Sau khi chỉ mục được tạo, công cụ kiểm tra lại plan.
So sánh cơ sở dữ liệu
Schema của hai cơ sở dữ liệu, hoặc của một cơ sở dữ liệu và bản snapshot của nó: cần tạo, thay đổi, xóa những gì. Dữ liệu được so sánh theo khóa chính; công cụ không so sánh bảng lớn (mặc định là hơn 100.000 dòng).
Migration
Plan hiển thị mức của từng câu lệnh. Tất cả migration được áp dụng sau một lần phê duyệt; nếu một tệp thay đổi, cần yêu cầu mới. Kế hoạch rollback được xây dựng từ những gì đã được ghi lại khi áp dụng migration.
fb_write tìm mức của từng câu lệnh trong một script. Script trộn các câu lệnh thuộc các mức khác nhau sẽ bị từ chối.
fbagent · Local API · 127.0.0.1
Dữ liệu fbagent
Agent fbagent đã chạy trên máy chủ HQbird. Thông qua MCP, trợ lý nhận được mọi thứ agent đã thu thập: báo cáo tình trạng, LWM (Light-weight Monitoring), gstat, trace, deadlock, trạng thái backup. Trợ lý cũng chạy các job của agent và thay đổi cài đặt của chúng, theo cùng các mức và phê duyệt.
| Việc | Công cụ | Mức |
|---|---|---|
| Báo cáo tình trạng máy chủ | fb_agent_status | 0 |
| LWM, gstat, số liệu cơ sở dữ liệu, trace, deadlock | fb_agent_artifact_get, fb_agent_perf_report | 0 |
| Cài đặt backup, sweep và restore | fb_agent_backup_config; mật khẩu và token được ẩn | 0 |
| Chạy một job của agent | fb_agent_job_run; backup, restore và script SQL là mức 2 | 1 · 2 |
| Thay đổi cài đặt job | fb_agent_config_set; thông tin đăng nhập, id và lệnh không thể thay đổi | 2 |
| Khởi động lại Firebird qua agent | fb_agent_restart, fb_agent_stop, fb_agent_start | 2 |
| Giấy phép và cập nhật | fb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply | 0 · 1 · 2 |
- Chỉ cục bộAgent chỉ chấp nhận yêu cầu trên 127.0.0.1. Địa chỉ agent lấy từ cấu hình máy chủ MCP, không phải từ cuộc trò chuyện.
- Token luôn được ẩnToken của agent không xuất hiện trong đầu ra của công cụ hay trong nhật ký kiểm toán.
- Phát hiện agent
fb_agent_discovertìm các agent trên máy chủ qua dịch vụ Windows hoặc unit systemd. Công cụ không đọc token. - ClusterNếu một node cluster được cài trên máy chủ,
fb_agent_restart,fb_agent_stopvàfb_agent_starttừ chối theo mặc định: node kiểm soát việc khởi động lại.fb_service_restartkhông kiểm tra điều này, nên không dùng nó trên node cluster.
Kiểm soát kép. Máy chủ MCP phê duyệt yêu cầu, và bản thân agent chạy job theo quy tắc riêng của nó. Nhật ký MCP cho biết ai đã yêu cầu; nhật ký agent cho biết việc đó đã được thực hiện thế nào.
HQbird Cluster · RCM
Cluster replication qua trợ lý
Trợ lý xây dựng cluster replication từng bước: bật RCM, mở cửa sổ ghép cặp, liên kết các host, đưa cơ sở dữ liệu vào quản lý và tạo bản sao cho replica. Trợ lý làm việc qua agent và RCM. Bạn không cần đăng nhập vào máy chủ qua SSH.
Các quy tắc giống như mọi nơi. Đọc không cần xác nhận. Thay đổi được xác nhận trong cuộc trò chuyện. Khởi động lại Firebird, sao chép cơ sở dữ liệu sang replica, gỡ một máy chủ khỏi cluster, switchover, failover và đưa master cũ trở lại được xác nhận trên máy chủ.
| Việc | Công cụ | Mức |
|---|---|---|
| Trạng thái cluster trên máy chủ | fb_agent_cluster: trống, trong cluster hoặc chủ sở hữu RCM; slot và cổng | 0 |
| Tổng quan cluster trong RCM | fb_cluster_status: node, cơ sở dữ liệu, lệnh, cảnh báo | 0 |
| Kiểm tra host trước khi liên kết | fb_cluster_probe: một dòng cho mỗi agent, dấu vân tay chứng chỉ | 0 |
| So sánh master và replica | fb_cluster_verify: số dòng của từng bảng | 0 |
| Bật RCM trên máy chủ | fb_agent_cluster_rcm | 1 |
| Cửa sổ ghép cặp | fb_agent_cluster_pairing: trạng thái, mở trong 1–24 giờ, đóng | 0 · 1 |
| Liên kết host | fb_cluster_link; yêu cầu hiển thị dấu vân tay để so sánh | 1 |
| Cơ sở dữ liệu và publication | fb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication | 1 |
| Mật khẩu RCM | fb_cluster_rcm_password: mật khẩu ngẫu nhiên mới, không hiển thị trong cuộc trò chuyện | 1 |
| Sao chép cơ sở dữ liệu sang replica | fb_cluster_reinit | 2 |
| Khởi động lại Firebird của một node | fb_cluster_firebird_restart | 2 |
| Gỡ một máy chủ khỏi cluster | fb_cluster_unlink | 2 |
| Dịch vụ: master ở đâu | fb_cluster_service: master, replica, router, sự cố, thao tác đang chạy | 0 |
| Mô tả dịch vụ và quy tắc của nó | fb_cluster_service_put, fb_cluster_service_policy: mô tả dịch vụ, quy tắc failover tự động | 1 |
| Tiếp tục và hủy thao tác | fb_cluster_resume, fb_cluster_operation_cancel; chỉ hủy trước điểm không thể quay lại | 1 |
| Switchover | fb_cluster_switchover: chuyển master theo kế hoạch, chờ thao tác kết thúc | 2 |
| Failover | fb_cluster_failover: chỉ khi có sự đồng ý rõ ràng về mất dữ liệu | 2 |
| Đưa master cũ trở lại | fb_cluster_rejoin | 2 |
| Xóa một dịch vụ | fb_cluster_service_delete: chỉ bản ghi trong RCM bị xóa | 2 |
- Kịch bản có sẵn“Xây dựng cluster”: trợ lý đi từng bước và ở mỗi bước hiển thị những gì nó sẽ làm.
- Dấu vân tayTrước khi liên kết, trợ lý hiển thị dấu vân tay chứng chỉ của từng máy chủ. Hãy so sánh với dòng trong bản tóm tắt cài đặt.
- Chạy thửTrước khi đưa một thư mục chứa cơ sở dữ liệu vào quản lý, trợ lý hiển thị những cơ sở dữ liệu mà RCM sẽ tìm thấy.
- Switchover và failoverTrợ lý bắt đầu việc chuyển master và theo dõi các bước của thao tác. Một người trên máy chủ xác nhận việc bắt đầu. Failover cũng cần sự đồng ý rõ ràng về mất dữ liệu. Thêm trên trang cluster.
HTTPS · API keys · audit
Chế độ từ xa, cài đặt và nhật ký kiểm toán
Trợ lý chạy trên PC của quản trị viên, còn máy chủ MCP chạy trên máy chủ cơ sở dữ liệu. Giữa chúng là HTTPS và một API key. Mỗi người có key riêng và mức tối đa riêng.
- Mỗi người một key
fbmcp ctl apikey new <name> --max-tier 2. Giá trị chỉ hiển thị một lần. Sau khi đổi key, key cũ ngừng hoạt động trong vài giây. - Giới hạnTheo key: số lệnh gọi đồng thời, số lệnh gọi mỗi phút, số phiên mở. Vượt giới hạn, phản hồi là 429.
- Hướng dẫn bằng tiếng Bồ Đào NhaHướng dẫn đầy đủ về cài đặt và sử dụng cũng có bằng tiếng Bồ Đào Nha Brazil.
- Agent tự trịHồ sơ
autonomous: mặc định chỉ đọc. Thay đổi phải chờ người vận hành trên máy chủ;fb_confirmtừ agent bị từ chối. 10 lệnh gọi mỗi phút. Chạy các agent như vậy trong mạng nội bộ công ty. - Địa chỉMột key có thể được gắn với địa chỉ (
allow_from). Địa chỉ khác nhận 403 và một mục trong nhật ký.
Cài đặt trong HQbird
Bộ cài HQbird cài máy chủ MCP theo mặc định. Một máy chủ phục vụ tất cả các dòng Firebird trên máy. Một lệnh thiết lập mọi thứ, và bạn có thể chạy lại.
- 1Bộ cài HQbirdWindows hoặc Linux
- 2fbmcp ctl hqbird-installmột lệnh, không cần sửa YAML thủ công
- 3Các dòng Firebirdtìm từng dòng và agent của nó
- 4Cơ sở dữ liệubí danh trong databases.conf và các cơ sở dữ liệu được kết nối gần đây
- 5✓ Dịch vụkhởi động, kiểm tra, kết nối tệp .txt cho máy khách
Chế độ từ xa được bật khi đáp ứng ba điều kiện: đã đặt danh sách địa chỉ quản trị viên (--allow-from), tường lửa đang chạy và có ít nhất một khóa API. Bạn tạo khóa riêng. Sau đó, chạy lại fbmcp ctl hqbird-install. Cổng mặc định là 8650.
Chuỗi băm
Mỗi quyết định (được phép, đang chờ, đã phê duyệt, bị từ chối) đều được ghi vào nhật ký. Mỗi mục được liên kết với mục trước đó. Việc kiểm tra chuỗi sẽ cho thấy liệu một mục đã bị thay đổi hoặc xóa hay không.
Nhật ký bị cắt ngắn — máy chủ vẫn ngừng hoạt động
Nếu nhật ký bị cắt ngắn hoặc phần cuối của nó không khớp với mục kiểm soát, máy chủ MCP sẽ không khởi động. Đây là dấu hiệu của việc bị can thiệp, và bạn phải điều tra. Lệnh fbmcp ctl verify kiểm tra toàn bộ chuỗi.
Thông qua agent
fbagent cập nhật máy chủ MCP: dừng, thay thế, khởi động, kiểm tra, khôi phục khi thất bại. Trên Linux, bản dựng chưa ký sẽ không được cài đặt. Cấu hình và khóa không thay đổi.