DESCRIBE MCP SERVER

MCP (モデルコンテキストプロトコル)サーバーのプロパティを記述します。

DESCRIBE は DESC に短縮できます。

こちらもご参照ください。

CREATE MCP SERVERDROP MCP SERVERSHOW MCP SERVERS

構文

{ DESC | DESCRIBE } MCP SERVER <name>
Copy

パラメーター

name

記述する MCP サーバーの識別子を指定します。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

出力

コマンドの出力には、オブジェクトのプロパティとメタデータを説明する以下の列が含まれます。

説明

name

MCP サーバーの名前。

database_name

MCP サーバーを含むデータベース。

schema_name

MCP サーバーを含むスキーマ。

owner

MCP サーバーを所有するロール。

comment

MCP サーバーのコメント。

server_spec

ツール構成を含む MCP サーバー仕様の JSON 表現。

created_on

MCP サーバーが作成された日時。

アクセス制御の要件

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

USAGE 、 MODIFY 、または OWNERSHIP

MCP Server

スキーマ内のオブジェクトを操作するには、親データベースの少なくとも1つの権限と、親スキーマの少なくとも1つの権限が必要です。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

  • このコマンドの出力を後処理するには、 パイプ演算子->>)または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。

    たとえば、パイプ演算子または RESULT_SCAN 関数を使用して、 SHOW コマンド出力から特定の列を選択したり、行をフィルター処理したりできます。

    出力列を参照する場合は、列名に 二重引用符で囲まれた識別子 を使用します。たとえば、出力列 type を選択するには、 SELECT "type" を指定します。

    SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。

  • server_spec 列には、 MCP サーバーが作成され、 JSON としてシリアル化されたときに提供された完全な YAML 仕様が含まれます。

次の例は、 my_mcp_server という名前の MCP サーバーについて記述しています。

DESCRIBE MCP SERVER my_mcp_server;
Copy
+-----------------+---------------+-------------+--------------+---------+--------------------------------------------------------------------------------------------------------------------------------+----------------------------------------+
|      name       | database_name | schema_name |    owner     | comment |                                                           server_spec                                                          |               created_on               |
+-----------------+---------------+-------------+--------------+---------+--------------------------------------------------------------------------------------------------------------------------------+----------------------------------------+
| MY_MCP_SERVER   | TEST_DATABASE | TEST_SCHEMA | ACCOUNTADMIN | [NULL]  | {"version":1,"tools":[{"name":"product-search","identifier":"db.schema.search_service","type":"CORTEX_SEARCH_SERVICE_QUERY"}]} | Fri, 23 Jun 1967 07:00:00.123000 +0000 |
+-----------------+---------------+-------------+--------------+---------+--------------------------------------------------------------------------------------------------------------------------------+----------------------------------------+