Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh. English

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.

    Call path: assistant, fbmcp policy check, four levels, audit log
    Cấp độCông cụVí dụCách phê duyệt
    0 · Đọc51phiên, giao dịch, kế hoạch truy vấn, gstat, firebird.log, báo cáo agentKhông cần. Giao dịch chỉ đọc.
    1 · Thay đổi31DML 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ênTrong chat: số yêu cầu và token, sau đó fb_confirm.
    2 · Thao tác nguy hiểm14thay thế cơ sở dữ liệu từ bản sao lưu, sửa firebird.conf, dừng và khởi động lại FirebirdChỉ 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óa1xóa cơ sở dữ liệuKhô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_cancel xó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 approve hoặ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ôngfb_ping, fb_db_list, fb_db_health, fb_service_status0
    Phiên và giao dịch dàifb_sessions, fb_transactions; để kết thúc một phiên — fb_session_kill0 · 1
    Nhật ký và thống kêfb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends0
    Sao lưu và xác minhfb_backup_start (gbak), fb_backup_nbackup, fb_restore_test1
    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ệufb_sweep, fb_validate (chỉ phát hiện, không sửa chữa)1
    Người dùng và quyềnfb_user_create, fb_grant, fb_revoke; SYSDBA và các tài khoản riêng của nó không thể bị xóa1
    Tracefb_trace_start chỉ với các mẫu: audit-lite, performance, errors1
    firebird.conffb_config_get, fb_config_diff; để sửa — fb_config_set, Firebird không được khởi động lại0 · 2
    Dịch vụ và thay thế cơ sở dữ liệufb_service_restart; fb_restore_replace, tệp cũ được giữ lại dưới dạng .pre-restore2

    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.

    1. 1Lịchfb_schedule_create, mục tiêu nightly_verify; được phê duyệt một lần
    2. 2Sao lưugbak vào thư mục sao lưu
    3. 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. 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.

    Kiểm tra tình trạng Tối ưu hóa Kiểm toán bảo mật Đánh giá DDL Kế hoạch di trú Sẵn sàng thảm họa Trình tạo truy vấn

    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.

    1. 1Nhiệm vụđiều bạn cần, trong một câu
    2. 2Sự thậtfb_schema_list, fb_describe: chỉ các bảng và cột tồn tại
    3. 3Bản nhápmột SELECT với ORDER BY
    4. 4Kiểm trafb_query_check: biên dịch mà không chạy
    5. 5✓ Bảng trong chatfb_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
    6 hàng · PLAN SORT (EMPLOYEE NATURAL) · chỉ đọc
    fb_index_advice

    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.

    fb_diff_schema · fb_diff_data

    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).

    fb_migration_*

    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ệcCông cụMức
    Báo cáo tình trạng máy chủfb_agent_status0
    LWM, gstat, số liệu cơ sở dữ liệu, trace, deadlockfb_agent_artifact_get, fb_agent_perf_report0
    Cài đặt backup, sweep và restorefb_agent_backup_config; mật khẩu và token được ẩn0
    Chạy một job của agentfb_agent_job_run; backup, restore và script SQL là mức 21 · 2
    Thay đổi cài đặt jobfb_agent_config_set; thông tin đăng nhập, id và lệnh không thể thay đổi2
    Khởi động lại Firebird qua agentfb_agent_restart, fb_agent_stop, fb_agent_start2
    Giấy phép và cập nhậtfb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply0 · 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 agentfb_agent_discover tì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_stop và fb_agent_start từ chối theo mặc định: node kiểm soát việc khởi động lại. fb_service_restart khô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ệcCô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ổng0
    Tổng quan cluster trong RCMfb_cluster_status: node, cơ sở dữ liệu, lệnh, cảnh báo0
    Kiểm tra host trước khi liên kếtfb_cluster_probe: một dòng cho mỗi agent, dấu vân tay chứng chỉ0
    So sánh master và replicafb_cluster_verify: số dòng của từng bảng0
    Bật RCM trên máy chủfb_agent_cluster_rcm1
    Cửa sổ ghép cặpfb_agent_cluster_pairing: trạng thái, mở trong 1–24 giờ, đóng0 · 1
    Liên kết hostfb_cluster_link; yêu cầu hiển thị dấu vân tay để so sánh1
    Cơ sở dữ liệu và publicationfb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication1
    Mật khẩu RCMfb_cluster_rcm_password: mật khẩu ngẫu nhiên mới, không hiển thị trong cuộc trò chuyện1
    Sao chép cơ sở dữ liệu sang replicafb_cluster_reinit2
    Khởi động lại Firebird của một nodefb_cluster_firebird_restart2
    Gỡ một máy chủ khỏi clusterfb_cluster_unlink2
    Dịch vụ: master ở đâufb_cluster_service: master, replica, router, sự cố, thao tác đang chạy0
    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ự động1
    Tiếp tục và hủy thao tácfb_cluster_resume, fb_cluster_operation_cancel; chỉ hủy trước điểm không thể quay lại1
    Switchoverfb_cluster_switchover: chuyển master theo kế hoạch, chờ thao tác kết thúc2
    Failoverfb_cluster_failover: chỉ khi có sự đồng ý rõ ràng về mất dữ liệu2
    Đưa master cũ trở lạifb_cluster_rejoin2
    Xóa một dịch vụfb_cluster_service_delete: chỉ bản ghi trong RCM bị xóa2
    • 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.

    PC quản trị với MCP client và cầu nối fbmcp, HTTPS qua tường lửa đến dịch vụ fbmcp; fbmcp giao tiếp với Firebird và fbagent; một người trên máy chủ phê duyệt các yêu cầu nguy hiểm
    Chế độ từ xa. Cầu nối trên PC lấy key từ kho khóa của hệ điều hành và kiểm tra chứng chỉ máy chủ bằng pin. Mật khẩu và đường dẫn cơ sở dữ liệu không đến cuộc trò chuyện: cơ sở dữ liệu được gọi bằng id.
    • Mỗi người một keyfbmcp 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_confirm từ 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.

    1. 1Bộ cài HQbirdWindows hoặc Linux
    2. 2fbmcp ctl hqbird-installmột lệnh, không cần sửa YAML thủ công
    3. 3Các dòng Firebirdtìm từng dòng và agent của nó
    4. 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. 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.

    audit.jsonl

    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.

    Thất bại — dừ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.

    Cập nhật

    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.

    ← Quay lại tổng quan HQbird 2027