SHOW MCP SERVERS

SHOW MCP SERVERS

SHOW MCP SERVERS 명령은 접근 권한(privilege)이 있는 MCP(Model Context Protocol) 서버 목록을 보여주는 명령이에요. 세션의 현재 데이터베이스·스키마, 지정한 데이터베이스·스키마, 또는 전체 계정의 MCP 서버를 나열할 수 있어요.

출처: 문서

본문

이 명령은 접근 권한이 있는 MCP 서버를 나열해요. 각 객체의 메타데이터와 속성이 출력에 포함되며, 객체는 데이터베이스, 스키마, 객체 이름 기준 사전 순으로 정렬돼요.

관련 명령: CREATE MCP SERVER, DESCRIBE MCP SERVER, DROP MCP SERVER.

구문 (Syntax)

SHOW MCP SERVERS [ LIKE '<pattern>' ]
           [ IN
                {
                  ACCOUNT                  |
                  DATABASE                 |
                  DATABASE <database_name> |
                  SCHEMA                   |
                  SCHEMA <schema_name>     |
                  <schema_name>
                }
           ]

파라미터 (Parameters)

  • LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.

  • [ IN ... ] — 명령의 범위를 선택적으로 지정해요:

    • ACCOUNT — 전체 계정의 레코드 반환.
    • DATABASE 또는 DATABASE db_name — 현재 또는 지정한 데이터베이스의 레코드 반환.
    • SCHEMA 또는 SCHEMA schema_name — 현재 또는 지정한 스키마의 레코드 반환.
    • IN ...을 생략하면 범위는 세션의 현재 데이터베이스 유무에 따라 달라져요: 있으면 IN DATABASE와 같은 효과, 없으면 IN ACCOUNT와 같은 효과.

출력 (Output)

명령 출력은 객체의 속성과 메타데이터를 설명하는 다음 컬럼을 포함해요:

  • created_on — MCP 서버가 생성된 날짜·시간.
  • name — MCP 서버 이름.
  • database_name — MCP 서버가 있는 데이터베이스.
  • schema_name — MCP 서버가 있는 스키마.
  • owner — MCP 서버를 소유한 역할.
  • comment — MCP 서버에 대한 주석.

접근 제어 요구 사항 (Access control requirements)

이 작업을 실행하는 역할은 최소한 다음 권한을 가져야 해요:

권한 (Privilege) 객체 (Object)
USAGE 데이터베이스 (IN DATABASE 지정 시)
USAGE 스키마 (IN SCHEMA 지정 시)

명령은 실행 역할이 보유한 권한에 따라 MCP 서버의 레코드를 반환해요.

사용 참고 사항 (Usage notes)

  • 실행에 실행 중인 웨어하우스를 요구하지 않아요.
  • 현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
  • MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.
  • 명령은 최대 1만 개의 레코드를 반환해요. 1만 개가 넘는 결과는 필터를 적용해도 반환되지 않아요.
  • 스키마 수준 객체에 대해 명령을 실행하면, 현재 역할이 상위 데이터베이스와 스키마에 최소 하나의 권한을 가진 경우에만 객체가 반환돼요.

예제 (Examples)

mydb 데이터베이스의 PUBLIC 스키마에서 볼 권한이 있는 MCP 서버를 나열해요:

USE DATABASE mydb;

SHOW MCP SERVERS;

지정한 데이터베이스의 MCP 서버를 나열해요:

SHOW MCP SERVERS IN DATABASE mydb;

지정한 스키마의 MCP 서버를 나열해요:

SHOW MCP SERVERS IN SCHEMA mydb.public;

계정의 모든 MCP 서버를 나열해요:

SHOW MCP SERVERS IN ACCOUNT;

더 알아보기 (Learn more)