このページは機械翻訳されています。英語の原文をお読みください。 English

人の管理下にある AI アシスタント

HQbird MCP は Firebird を AI アシスタントに接続します。あなたは普通の言葉で書くだけで、アシスタントが自分でツールを選びます。読み取りは自由に行えます。変更はそれぞれあなたの「はい」を待ち、危険なものはサーバー上での承認を待ちます。

  • 122 ツール
  • 56 読み取り専用
  • Firebird 2.5–5 Windows と Linux
  • 2 チャネル 承認用
  • 監査ログ ハッシュチェーン付き

例

アシスタントとの会話

ユーザーからデータベースが遅いという苦情が来ました。アシスタントはデータを読み、原因を見つけ、アクションを提案してあなたの判断を待ちます。例の中の名前と数値は架空のものです。

どの MCP クライアントでも動作します: Claude Desktop、Claude Code、Cursor、Codex、ZCode など。

    ポリシー · 承認

    4 つの危険レベル

    各ツールにはレベルがあります。MCP サーバーは呼び出しが実行される前に、レベルと条件を自分で確認します。何かを変更する呼び出しは、結果ではなく承認リクエストを返します。アシスタントはこのチェックを回避できません。

    ツールを選んで、その呼び出しがたどる経路を確認してください。

    Call path: assistant, fbmcp policy check, four levels, audit log
    レベルツール例承認方法
    0 · 読み取り51セッション、トランザクション、クエリプラン、gstat、firebird.log、エージェントレポート不要。読み取り専用トランザクション。
    1 · 変更31DML と DDL、バックアップ、テスト復元、スイープ、ユーザーと権限、セッションの終了チャット内で: リクエスト番号とトークン、その後 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_status0
    セッションと長時間トランザクションfb_sessions, fb_transactions; セッションを終了するには — fb_session_kill0 · 1
    ログと統計fb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends0
    バックアップと検証fb_backup_start (gbak), fb_backup_nbackup, fb_restore_test1
    古いバックアップfb_retention_run: まずドライラン; 自身のカタログにある検証済みバックアップのみ削除1
    スイープとデータベース検証fb_sweep, fb_validate (検出のみ、修復なし)1
    ユーザーと権限fb_user_create, fb_grant, fb_revoke; SYSDBA と自身のアカウントは削除できません1
    トレースfb_trace_start はテンプレートのみ: audit-lite、performance、errors1
    firebird.conffb_config_get, fb_config_diff; 編集するには — fb_config_set、Firebird は再起動されません0 · 2
    サービスとデータベースの置き換えfb_service_restart; fb_restore_replace、古いファイルは .pre-restore として残ります2

    夜間バックアップチェック

    スケジュールは作成時に一度だけ承認されます。その後は人の手を借りずに実行されます。毎晩、検証済みのバックアップが得られます。たとえば、バックアップからデータベースを置き換えるために必要になります。

    1. 1スケジュールfb_schedule_create、ゴールはnightly_verify。一度だけ承認
    2. 2バックアップgbakでバックアップフォルダへ
    3. 3テストリストア作業フォルダへ。ソースデータベースには触れません
    4. 4✓ バックアップ検証済みバックアップカタログにマーク

    バックアップからのデータベース置き換えとレベル3の操作はスケジュールできません。

    すぐに使えるシナリオ

    シナリオはアシスタントに手順の順序を提案します。シナリオ自体が変更を適用することはありません。

    ヘルスチェック 最適化 セキュリティ監査 DDLレビュー 移行計画 災害対策準備 クエリビルダー

    クエリ · インデックス · 移行

    開発者向け

    CursorやClaude Codeのアシスタントはスキーマを把握し、クエリを実行前にチェックし、結果をチャット上にそのまま表として表示します。

    1. 1タスク必要なことを一文で
    2. 2事実fb_schema_list、fb_describe:既存のテーブルとカラムのみ
    3. 3下書きORDER BY付きのSELECTを1つ
    4. 4チェックfb_query_check:実行せずにコンパイル
    5. 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
    6行 · PLAN SORT (EMPLOYEE NATURAL) · 読み取り専用
    fb_index_advice

    インデックスのアドバイス

    テーブル全体のスキャンを検出し、効果の見積もりとともにCREATE INDEXを提案します。インデックス自体は作成しません。作成するのは承認を伴うfb_writeです。インデックス作成後、プランを再度チェックします。

    fb_diff_schema · fb_diff_data

    データベース比較

    2つのデータベース、またはデータベースとそのスナップショットのスキーマ:作成・変更・削除すべきもの。データは主キーで比較されます。大きなテーブル(デフォルトでは100,000行超)は比較しません。

    fb_migration_*

    移行

    プランには各ステートメントのレベルが表示されます。すべての移行は一度の承認後に適用されます。ファイルが変更された場合は、新たな要求が必要です。ロールバックプランは、移行適用時に記録された内容から構築されます。

    fb_writeはスクリプト内の各ステートメントのレベルを判定します。異なるレベルのステートメントが混在するスクリプトは拒否されます。

    fbagent · ローカルAPI · 127.0.0.1

    fbagentのデータ

    fbagentエージェントはすでにHQbirdサーバー上で動作しています。MCPを通じて、アシスタントはエージェントが収集したすべての情報を取得できます:ヘルスレポート、LWM(Light-weight Monitoring)、gstat、トレース、デッドロック、バックアップステータス。また、同じレベルと承認のもとで、エージェントジョブの実行や設定の変更も行います。

    内容ツールレベル
    サーバーヘルスレポートfb_agent_status0
    LWM、gstat、データベースメトリクス、トレース、デッドロックfb_agent_artifact_get、fb_agent_perf_report0
    バックアップ、スイープ、リストアの設定fb_agent_backup_config;パスワードとトークンは非表示0
    エージェントジョブの実行fb_agent_job_run;バックアップ、リストア、SQLスクリプトはレベル21 · 2
    ジョブ設定の変更fb_agent_config_set;認証情報、ID、コマンドは変更不可2
    エージェント経由でのFirebirdの再起動fb_agent_restart、fb_agent_stop、fb_agent_start2
    ライセンスとアップデートfb_agent_license、fb_agent_license_set、fb_agent_update_apply、fb_agent_product_update_apply0 · 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 の再起動、レプリカへのデータベースコピー、クラスタからのサーバー削除、スイッチオーバー、フェイルオーバー、および旧マスターの復帰は、サーバー上で確認されます。

    内容ツールレベル
    サーバー上のクラスタ状態fb_agent_cluster: フリー、クラスタ内、または RCM オーナー。スロットとポート0
    RCM でのクラスタ概要fb_cluster_status: ノード、データベース、コマンド、アラート0
    リンク前のホスト確認fb_cluster_probe: エージェントごとに 1 行、証明書フィンガープリント0
    マスターとレプリカの比較fb_cluster_verify: 各テーブルの行数0
    サーバーで RCM を有効化fb_agent_cluster_rcm1
    ペアリングウィンドウfb_agent_cluster_pairing: 状態、1〜24 時間開く、閉じる0 · 1
    ホストのリンクfb_cluster_link。リクエストに比較用のフィンガープリントが表示されます1
    データベースとパブリケーションfb_cluster_replica_folder、fb_cluster_enroll、fb_cluster_publication1
    RCM パスワードfb_cluster_rcm_password: 新しいランダムパスワード、チャットには表示されません1
    レプリカへのデータベースコピーfb_cluster_reinit2
    ノードの Firebird の再起動fb_cluster_firebird_restart2
    クラスタからのサーバー削除fb_cluster_unlink2
    サービス: マスターの所在fb_cluster_service: マスター、レプリカ、ルーター、問題、実行中の操作0
    サービスの説明とルールfb_cluster_service_put、fb_cluster_service_policy: サービスの説明、自動フェイルオーバールール1
    操作の再開とキャンセルfb_cluster_resume、fb_cluster_operation_cancel。キャンセルはポイント・オブ・ノーリターンより前のみ1
    スイッチオーバーfb_cluster_switchover: マスターの計画的な移動、操作の終了を待機2
    フェイルオーバーfb_cluster_failover: データ損失への明示的な同意がある場合のみ2
    旧マスターの復帰fb_cluster_rejoin2
    サービスの削除fb_cluster_service_delete: RCM のレコードのみ削除されます2
    • 既製のシナリオ「クラスタを構築する」: アシスタントは段階的に進み、各ステップで何を行うかを示します。
    • フィンガープリントリンク前に、アシスタントは各サーバーの証明書フィンガープリントを表示します。インストール概要の行と比較してください。
    • ドライランデータベースを含むフォルダーを管理下に置く前に、アシスタントは RCM が検出するデータベースを表示します。
    • スイッチオーバーとフェイルオーバーアシスタントはマスターの移動を開始し、操作の各ステップを追跡します。開始はサーバー上の担当者が確認します。フェイルオーバーにはデータ損失への明示的な同意も必要です。クラスタページの詳細。

    HTTPS · API キー · 監査

    リモートモード、インストール、監査ログ

    アシスタントは管理者の PC 上で動作し、MCP サーバーはデータベースサーバー上で動作します。両者の間は HTTPS と API キーで接続されます。各ユーザーはそれぞれ独自のキーと独自の最大レベルを持ちます。

    MCP クライアントと fbmcp ブリッジを備えた管理者 PC、ファイアウォール経由の HTTPS で fbmcp サービスへ。fbmcp は Firebird と fbagent と通信。危険なリクエストはサーバー上の担当者が承認
    リモートモード。 PC 上のブリッジは OS のキーストアからキーを取得し、ピン留めによってサーバー証明書を検証します。パスワードとデータベースパスはチャットに届きません。データベースは id で指定されます。
    • ユーザーごとのキーfbmcp ctl apikey new <name> --max-tier 2。値は一度だけ表示されます。キーを変更すると、古いキーは数秒以内に機能しなくなります。
    • 制限キーごと: 同時呼び出し数、1 分あたりの呼び出し数、オープンセッション数。制限を超えると 429 が返されます。
    • ポルトガル語のガイドインストールと使用方法の完全なガイドは、ブラジルポルトガル語でも利用できます。
    • 自律エージェントautonomous プロファイル: デフォルトでは読み取り専用。変更はサーバー上のオペレーターを待機します。エージェントからの fb_confirm は拒否されます。1 分あたり 10 回の呼び出し。このようなエージェントは社内ネットワーク内で実行してください。
    • アドレスキーはアドレスにバインドできます(allow_from)。別のアドレスからは 403 とログへの記録が返されます。

    HQbird へのインストール

    HQbird インストーラーはデフォルトで MCP サーバーをインストールします。1 つのサーバーがマシン上のすべての Firebird ラインにサービスを提供します。1 つのコマンドですべてを設定でき、再度実行することもできます。

    1. 1HQbird インストーラーWindows または Linux
    2. 2fbmcp ctl hqbird-install1 つのコマンド、手動での YAML 編集は不要
    3. 3Firebird ライン各ラインとそのエージェントを検出
    4. 4データベースdatabases.conf のエイリアスと最近接続されたデータベース
    5. 5✓ サービス起動、確認、クライアント用の connect.txt ファイル

    リモートモードは、次の3つの条件が満たされたときに有効になります。管理者アドレスのリストが設定されている(--allow-from)、ファイアウォールが稼働している、そして少なくとも1つのAPIキーが存在していることです。キーは別途作成します。その後、fbmcp ctl hqbird-install を再度実行してください。デフォルトのポートは8650です。

    audit.jsonl

    ハッシュチェーン

    各判定(許可、保留、承認、拒否)はログに書き込まれます。各エントリは前のエントリにリンクされます。チェーンを検査すると、エントリが変更または削除されたかどうかがわかります。

    失敗 — 停止

    ログが途中で切れている — サーバーは停止したまま

    ログが途中で切れている場合、またはその末尾が制御エントリと一致しない場合、MCPサーバーは起動しません。これは改ざんの兆候であり、調査する必要があります。fbmcp ctl verify コマンドはチェーン全体を検査します。

    更新

    エージェント経由で

    fbagent が MCPサーバーを更新します。停止、置換、起動、確認、失敗時はロールバックします。Linux では署名されていないビルドはインストールされません。設定とキーは変更されません。

    ← HQbird 2027 の概要に戻る