事前作成およびカスタム・ツール

データベース・ツールのMCPツールセットについて学習します。

次の表に、データベース・ツールのMCPツールセット・タイプ、ツールが事前作成済かカスタムか、特定のツール名、およびそれらを使用するために必要なデフォルトの許可ロールの概要を示します。

表5-1ツールセット

ツールセット・タイプ ツール・タイプ ツール名 摘要 デフォルト許可ロール
カスタムSQL カスタム カスタマイズされたツール名 このツールは、定義する場合に使用します。 MCP_オペレータ
組込みSQL 事前ビルド dbtools_実行_sql

このツールは、データベースの直接問合せまたは変更、スキーマ・オブジェクトの検査、またはプロシージャ・ロジックの実行が必要な場合に使用します。ソース引数には、実行するSQLまたはスクリプトが含まれている必要があります。

MCP_オペレータ
カスタマイズ可能なレポートツール 事前ビルド

データベース・ツール・リスト・レポート

このツールを使用して、存在するレポートを検出し、そのメタデータ(レポートID (SQLレポートのID)、表示名、説明、目的および使用手順など)を取得します。dbtools_execute_reportまたはdbtools_get_report_sqlをコールする場合、返されるreportId値が必要です。 MCP_User、MCP_Operator、MCP_Administrator

dbtools_実行レポート

実行するレポートのreportIdを、必要な変数値とともに指定します。レポートで定義された変数のプレースホルダは、実行時に指定された引数に置き換えられます。結果セットはCSV形式のコンテンツとして返されるため、プログラムによる消費やユーザーへの表示が容易になります。このツールを呼び出す前に、dbtools_list_reportsを使用して正しいreportIdを識別します。

MCP_User、MCP_Operator、MCP_Administrator
dbtools_get_report_sql

このツールは、レポートで使用されるSQLを検査、理解またはカスタマイズする必要がある場合に使用します。戻されたSQLは、dbtools_execute_sqlを使用して直接変更および実行できます。このツールには、dbtools_list_reportsから取得できる有効なreportIdが必要です。

MCP_オペレータ
dbtools_get_tool_リクエスト

現在のステータスを取得し、以前に送信された非同期ツール・コールの最終結果を取得します(使用可能な場合)。

MCP_オペレータ