이 페이지에서는 모델 컨텍스트 프로토콜 (MCP)을 통해 Gemini CLI 또는 AI 에이전트와 같은 MCP 클라이언트를 사용하여 Mainframe Assessment Tool 평가를 설정하고 상호작용하는 방법을 설명합니다. 자연어 프롬프트를 사용하여 메인프레임 평가에 대한 통계를 얻을 수 있습니다. MCP 서버를 사용하면 AI 에이전트를 사용하여 Mainframe Assessment Tool 평가에 대한 탐색 및 분석 작업을 수행할 수 있습니다. 예를 들어 다음 작업을 할 수 있습니다.
- 기존 평가를 나열하고 봅니다.
- 평가에서 발견된 비즈니스 도메인을 살펴봅니다.
- 다양한 기준에 따라 애셋을 검색하고 필터링합니다.
- 종속 항목 및 복잡성 측정항목을 포함한 애셋 사양을 검색합니다.
MCP에 대한 자세한 내용은 모델 컨텍스트 프로토콜 (MCP)이란 무엇인가요?를 참조하세요.
시작하기 전에
MCP 서버를 사용 설정하고 연결할 준비를 하려면 다음 작업을 완료하세요.
- Mainframe Assessment Tool에 익숙해지세요. Mainframe Assessment Tool을 사용하여 평가를 이미 실행했는지 확인합니다.
- 필요한 권한을 부여합니다. Mainframe Assessment ToolMCP 서버를 사용 설정하려면 VM 인스턴스에서 커스텀 메타데이터를 설정할 수 있는 권한이 필요합니다. 필요한 역할 및 권한에 대한 자세한 내용은 커스텀 메타데이터 설정 및 삭제 를 참조하세요.
- Google Cloud CLI를 설정합니다. Google Cloud CLI의 최신 버전을 설치하고 구성합니다. 자세한 내용은 Google Cloud CLI 설치를 참조하세요.
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 서버에 연결
스트리밍 가능한 HTTP를 통해 MCP 연결을 지원하는 표준 AI 에이전트를 사용하여 MCP 서버에 연결할 수 있습니다.
MCP 서버는 Mainframe Assessment Tool UI에 액세스하는 데 사용되는 동일한 포트의 /mcp/ 경로에 있습니다. 컴퓨터에서 Mainframe Assessment Tool VM에 액세스하기를 참조하세요.
구성 예
다음 섹션에서는 MCP 서버에 연결하도록 다양한 AI 에이전트를 구성하는 방법을 보여주는 예를 제공합니다.
LOCAL_PORT를 Mainframe Assessment Tool UI에 액세스하는 데 사용되는 로컬 포트로 바꿉니다.
Gemini CLI
Gemini CLI를 사용하려면 Gemini CLI 설정 파일에서 다음과 같이 MCP 서버를 구성합니다.
{
"mcpServers": {
"mainframe-assessment-tool": {
"httpUrl": "http://localhost:LOCAL_PORT/mcp/"
}
}
}
자세한 내용은 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 목록입니다. |
ListBusinessRulesExtractionJobs
지정된 Mainframe Assessment Tool 평가 ID의 비즈니스 규칙 작업을 나열합니다. 반환된 목록에는 각 작업의 ID, 이름, 상태, 포커스 프롬프트 등이 포함됩니다.
인수
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
AssessmentId |
문자열 | 예 | Mainframe Assessment Tool 평가의 ID입니다. |
ListBusinessRules
지정된 비즈니스 규칙 추출 작업 ID 및 Mainframe Assessment Tool 평가 ID로 추출된 비즈니스 규칙을 나열합니다. 많은 양의 규칙을 처리하기 위해 이 작업은 페이지로 나누기를 지원합니다.
인수
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
AssessmentId |
문자열 | 예 | Mainframe Assessment Tool 평가의 ID입니다. |
JobId |
문자열 | 예 | 비즈니스 규칙 추출 작업의 ID입니다. |
PageSize |
문자열 | 아니요 | 가져올 페이지의 크기입니다. 지원되는 최대값은 `25`입니다. |
PageToken |
문자열 | 아니요 | 가져올 페이지의 토큰입니다. 이 값은 이 작업에 대한 이전 호출에서 반환되었습니다. |
OrderList |
객체 | 아니요 | 결과를 반환할 순서입니다. 필드별 설명을 참조하세요. |
OrderList.OrderBy |
문자열 | 아니요 | 결과를 정렬할 필드의 이름입니다. 예: business_rule_id, business_rule_name, status |
OrderList.Order |
문자열 | 아니요 | 순서의 방향입니다. 지원되는 값은 ASCENDING, DESCENDING입니다. |
Filter |
객체 | 아니요 | 반환된 결과를 필터링합니다. 필드별 설명을 참조하세요. |
Filter.Status |
문자열 | 아니요 | 필터링할 비즈니스 규칙 상태입니다. 지원되는 값은 PENDING, VALIDATED, OBSOLETE입니다. |
Filter.Tags |
문자열[] | 아니요 | 비즈니스 규칙과 연결된 태그 목록입니다. |
Filter.AssetIDs |
문자열[] | 아니요 | 비즈니스 규칙과 연결된 Mainframe Assessment Tool 애셋 ID 목록입니다. |
사용 예시
다음은 AI 에이전트가 MCP 서버 도구를 사용하여 평가 데이터를 가져오고 처리하여 답변할 수 있는 자연어 프롬프트의 예입니다.
- 시나리오: 평가에서 복잡한 프로그램을 찾습니다.
- 사용자 프롬프트: "
AssessmentName이라는 평가에서 가장 복잡한 COBOL 프로그램 10개를 나열해 줘." - 시나리오: 비즈니스 도메인에 속한 애셋을 찾고 필터링합니다.
- 사용자 프롬프트: "
AssessmentName이라는 평가에서DomainName도메인과 관련된 모든 JCL 작업을 나열해 줘." - 시나리오: 평가에서 애셋 종속 항목을 가져옵니다.
- 사용자 프롬프트: "
AssessmentName이라는 평가에서 JCL 작업JCLJobName의 종속 항목은 무엇이야?" - 시나리오: 특정 작업에서 추출된 비즈니스 규칙을 찾습니다.
- 사용자 프롬프트: "
AssessmentName이라는 평가에서BusinessRuleJobName으로 추출된 모든 비즈니스 규칙을 나열해 줘."