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 など。
ポリシー · 承認
4 つの危険レベル
各ツールにはレベルがあります。MCP サーバーは呼び出しが実行される前に、レベルと条件を自分で確認します。何かを変更する呼び出しは、結果ではなく承認リクエストを返します。アシスタントはこのチェックを回避できません。
ツールを選んで、その呼び出しがたどる経路を確認してください。
| レベル | ツール | 例 | 承認方法 |
|---|---|---|---|
| 0 · 読み取り | 51 | セッション、トランザクション、クエリプラン、gstat、firebird.log、エージェントレポート | 不要。読み取り専用トランザクション。 |
| 1 · 変更 | 31 | DML と 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_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 |
| スイープとデータベース検証 | 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下書きORDER BY付きのSELECTを1つ
- 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です。インデックス作成後、プランを再度チェックします。
データベース比較
2つのデータベース、またはデータベースとそのスナップショットのスキーマ:作成・変更・削除すべきもの。データは主キーで比較されます。大きなテーブル(デフォルトでは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 |
| バックアップ、スイープ、リストアの設定 | 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 の再起動、レプリカへのデータベースコピー、クラスタからのサーバー削除、スイッチオーバー、フェイルオーバー、および旧マスターの復帰は、サーバー上で確認されます。
| 内容 | ツール | レベル |
|---|---|---|
| サーバー上のクラスタ状態 | fb_agent_cluster: フリー、クラスタ内、または RCM オーナー。スロットとポート | 0 |
| RCM でのクラスタ概要 | fb_cluster_status: ノード、データベース、コマンド、アラート | 0 |
| リンク前のホスト確認 | fb_cluster_probe: エージェントごとに 1 行、証明書フィンガープリント | 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: サービスの説明、自動フェイルオーバールール | 1 |
| 操作の再開とキャンセル | fb_cluster_resume、fb_cluster_operation_cancel。キャンセルはポイント・オブ・ノーリターンより前のみ | 1 |
| スイッチオーバー | fb_cluster_switchover: マスターの計画的な移動、操作の終了を待機 | 2 |
| フェイルオーバー | fb_cluster_failover: データ損失への明示的な同意がある場合のみ | 2 |
| 旧マスターの復帰 | fb_cluster_rejoin | 2 |
| サービスの削除 | fb_cluster_service_delete: RCM のレコードのみ削除されます | 2 |
- 既製のシナリオ「クラスタを構築する」: アシスタントは段階的に進み、各ステップで何を行うかを示します。
- フィンガープリントリンク前に、アシスタントは各サーバーの証明書フィンガープリントを表示します。インストール概要の行と比較してください。
- ドライランデータベースを含むフォルダーを管理下に置く前に、アシスタントは RCM が検出するデータベースを表示します。
- スイッチオーバーとフェイルオーバーアシスタントはマスターの移動を開始し、操作の各ステップを追跡します。開始はサーバー上の担当者が確認します。フェイルオーバーにはデータ損失への明示的な同意も必要です。クラスタページの詳細。
HTTPS · API キー · 監査
リモートモード、インストール、監査ログ
アシスタントは管理者の PC 上で動作し、MCP サーバーはデータベースサーバー上で動作します。両者の間は HTTPS と API キーで接続されます。各ユーザーはそれぞれ独自のキーと独自の最大レベルを持ちます。
- ユーザーごとのキー
fbmcp ctl apikey new <name> --max-tier 2。値は一度だけ表示されます。キーを変更すると、古いキーは数秒以内に機能しなくなります。 - 制限キーごと: 同時呼び出し数、1 分あたりの呼び出し数、オープンセッション数。制限を超えると 429 が返されます。
- ポルトガル語のガイドインストールと使用方法の完全なガイドは、ブラジルポルトガル語でも利用できます。
- 自律エージェント
autonomousプロファイル: デフォルトでは読み取り専用。変更はサーバー上のオペレーターを待機します。エージェントからのfb_confirmは拒否されます。1 分あたり 10 回の呼び出し。このようなエージェントは社内ネットワーク内で実行してください。 - アドレスキーはアドレスにバインドできます(
allow_from)。別のアドレスからは 403 とログへの記録が返されます。
HQbird へのインストール
HQbird インストーラーはデフォルトで MCP サーバーをインストールします。1 つのサーバーがマシン上のすべての Firebird ラインにサービスを提供します。1 つのコマンドですべてを設定でき、再度実行することもできます。
- 1HQbird インストーラーWindows または Linux
- 2fbmcp ctl hqbird-install1 つのコマンド、手動での YAML 編集は不要
- 3Firebird ライン各ラインとそのエージェントを検出
- 4データベースdatabases.conf のエイリアスと最近接続されたデータベース
- 5✓ サービス起動、確認、クライアント用の connect.txt ファイル
リモートモードは、次の3つの条件が満たされたときに有効になります。管理者アドレスのリストが設定されている(--allow-from)、ファイアウォールが稼働している、そして少なくとも1つのAPIキーが存在していることです。キーは別途作成します。その後、fbmcp ctl hqbird-install を再度実行してください。デフォルトのポートは8650です。
ハッシュチェーン
各判定(許可、保留、承認、拒否)はログに書き込まれます。各エントリは前のエントリにリンクされます。チェーンを検査すると、エントリが変更または削除されたかどうかがわかります。
ログが途中で切れている — サーバーは停止したまま
ログが途中で切れている場合、またはその末尾が制御エントリと一致しない場合、MCPサーバーは起動しません。これは改ざんの兆候であり、調査する必要があります。fbmcp ctl verify コマンドはチェーン全体を検査します。
エージェント経由で
fbagent が MCPサーバーを更新します。停止、置換、起動、確認、失敗時はロールバックします。Linux では署名されていないビルドはインストールされません。設定とキーは変更されません。