Mainframe Assessment Tool MCP 서버

이 페이지에서는 모델 컨텍스트 프로토콜 (MCP)을 통해 Gemini CLI 또는 AI 에이전트와 같은 MCP 클라이언트를 사용하여 메인프레임 평가 도구 평가를 설정하고 상호작용하는 방법을 설명합니다. 자연어 프롬프트를 사용하여 메인프레임 평가에 대한 유용한 정보를 얻을 수 있습니다. MCP 서버를 사용하면 AI 에이전트를 사용하여 Mainframe Assessment Tool 평가에 대한 검색 및 분석 작업을 실행할 수 있습니다. 예를 들어 다음과 같은 작업을 할 수 있습니다.

기존 평가를 나열하고 확인합니다.
평가에서 발견된 비즈니스 도메인을 살펴봅니다.
다양한 기준에 따라 애셋을 검색하고 필터링합니다.
종속 항목 및 복잡성 측정항목을 포함한 애셋 사양을 가져옵니다.

MCP에 대한 자세한 내용은 모델 컨텍스트 프로토콜 (MCP)이란 무엇인가요?를 참고하세요.

시작하기 전에

Mainframe Assessment Tool에 대해 잘 알고 있고 이미 이를 사용하여 평가를 실행했는지 확인합니다.

MCP 서버 사용 설정

Mainframe Assessment Tool VM 인스턴스에서 MCP 서버를 사용 설정하려면 다음 gcloud 명령어를 실행하여 MAT_ENABLE_MCP 메타데이터 키를 추가하고 값을 true로 설정합니다.

    gcloud compute instances add-metadata INSTANCE_NAME \
    --metadata=MAT_ENABLE_MCP=true \
    --zone=ZONE

다음을 바꿉니다.

INSTANCE_NAME: VM 인스턴스의 이름입니다.
ZONE: VM 인스턴스가 있는 영역입니다.

실행 중인 VM에서 메타데이터 키를 설정하는 경우 변경사항을 적용하려면 VM을 다시 시작해야 합니다.

MCP 서버에 연결

SSE (서버 전송 이벤트)를 통한 MCP 연결을 지원하는 표준 AI 에이전트를 사용하여 MCP 서버에 연결할 수 있습니다.

MCP 서버는 메인프레임 평가 도구 UI에 액세스하는 데 사용되는 동일한 포트의 /mcp/ 경로에 있습니다(컴퓨터에서 메인프레임 평가 도구 VM 액세스 참고).

예를 들어 Gemini CLI를 사용하려면 Gemini CLI 설정 파일에서 MCP 서버를 다음과 같이 구성합니다.

{
  "mcpServers": {
    "mainframe-assessment-tool": {
      "url": "http://localhost:LOCAL_PORT/mcp/"
    }
  }
}

다음을 바꿉니다.

LOCAL_PORT: Mainframe Assessment Tool UI에 액세스하는 데 사용되는 로컬 포트입니다.

자세한 내용은 settings.json에서 MCP 서버 구성을 참고하세요.

MCP 서버 도구

Mainframe Assessment Tool MCP 서버는 AI 에이전트가 평가에서 데이터를 가져올 수 있도록 지원하는 도구를 제공합니다.

ListAssessments

Mainframe Assessment Tool 인스턴스에 있는 모든 평가를 나열합니다. 각 평가에는 이름, ID, 설명, 타임스탬프가 포함됩니다.

ListDomains

지정된 Mainframe Assessment Tool 평가 ID의 도메인을 나열합니다. 각 도메인에는 이름, 설명, ID가 포함됩니다.

인수

이름	유형	필수	설명
`AssessmentId`	문자열	예	Mainframe Assessment Tool 평가의 ID입니다.

ListAssets

지정된 Mainframe Assessment Tool 평가 ID의 애셋을 나열합니다. 각 애셋에는 ID, 이름, 경로, 유형, 할당된 도메인 ID가 포함됩니다.

인수

이름	유형	필수	설명
`AssessmentId`	문자열	예	Mainframe Assessment Tool 평가의 ID입니다.

FetchDomain

지정된 도메인 ID 및 Mainframe Assessment Tool 평가 ID의 도메인 세부정보를 가져옵니다. 도메인 세부정보에는 ID, 이름, 설명, 요약이 포함됩니다.

인수

이름	유형	필수	설명
`AssessmentId`	문자열	예	Mainframe Assessment Tool 평가의 ID입니다.
`DomainId`	문자열	예	Mainframe Assessment Tool 도메인의 ID입니다.

FetchAsset

지정된 Mainframe Assessment Tool 평가 ID의 애셋 사양 요약을 가져옵니다. 애셋 사양에는 ID, 이름, 사용량, 설명, ETL 그래프, BMS 지도가 포함됩니다.

인수

이름	유형	필수	설명
`AssessmentId`	문자열	예	Mainframe Assessment Tool 평가의 ID입니다.
`AssetId`	문자열	예	Mainframe Assessment Tool 애셋의 ID입니다.
`DetailedSpec`	부울	아니요 (기본값: `false`)	true로 설정된 경우 응답에는 테스트 사례가 포함된 메서드 사양도 포함됩니다.

FetchAssetsCyclomaticComplexity

지정된 Mainframe Assessment Tool 평가 ID의 애셋 목록에 대한 순환 복잡도 점수를 가져옵니다.

인수

이름	유형	필수	설명
`AssessmentId`	문자열	예	Mainframe Assessment Tool 평가의 ID입니다.
`AssetIds`	문자열[]	예	Mainframe Assessment Tool 애셋 ID 목록입니다.

사용 예시

다음은 AI 에이전트가 MCP 서버 도구를 사용하여 평가 데이터를 검색하고 처리하여 대답할 수 있는 자연어 프롬프트의 예입니다.

시나리오: 평가에서 복잡한 프로그램 찾기
사용자 프롬프트: 'AssessmentName이라는 평가에서 가장 복잡한 COBOL 프로그램 10개를 나열해 줘.'
시나리오: 비즈니스 도메인에 속한 애셋을 찾아 필터링합니다.
사용자 프롬프트: 'AssessmentName이라는 평가에 속한 DomainName 도메인과 관련된 모든 JCL 작업을 나열해 줘.'
시나리오: 평가에서 애셋 종속 항목을 가져옵니다.
사용자 프롬프트: 'AssessmentName라는 평가에서 JCL 작업 JCLJobName의 종속 항목은 무엇인가요?'