Server MCP Mainframe Assessment Tool

Halaman ini menjelaskan cara menyiapkan dan berinteraksi dengan penilaian Mainframe Assessment Tool menggunakan klien MCP seperti Gemini CLI atau agen AI melalui Model Context Protocol (MCP). Anda dapat menggunakan perintah bahasa natural untuk mendapatkan insight tentang penilaian mainframe. Dengan server MCP, Anda dapat menggunakan agen AI untuk melakukan operasi penemuan dan analisis pada penilaian Mainframe Assessment Tool Anda. Misalnya, Anda dapat melakukan hal berikut:

  • Mencantumkan dan melihat penilaian yang ada.
  • Jelajahi domain bisnis yang ditemukan dalam penilaian Anda.
  • Telusuri dan filter aset berdasarkan kriteria yang berbeda.
  • Mengambil spesifikasi aset, termasuk metrik dependensi dan kompleksitas.

Untuk mengetahui informasi selengkapnya tentang MCP, lihat artikel Apa itu Model Context Protocol (MCP)?.

Sebelum memulai

Pastikan Anda memahami Mainframe Assessment Tool, dan Anda telah menggunakannya untuk menjalankan penilaian.

Mengaktifkan server MCP

Untuk mengaktifkan server MCP di instance VM Alat Penilaian Mainframe, tambahkan kunci metadata MAT_ENABLE_MCP dan tetapkan nilainya ke true dengan menjalankan perintah gcloud berikut:

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

Ganti kode berikut:

  • INSTANCE_NAME: nama instance VM Anda.
  • ZONE: zona tempat instance VM Anda berada.

Jika Anda menyetel kunci metadata pada VM yang sedang berjalan, Anda harus memulai ulang VM agar perubahan diterapkan.

Terhubung ke server MCP

Anda dapat terhubung ke server MCP menggunakan agen AI standar yang mendukung koneksi MCP melalui SSE (Server-Sent Events).

Server MCP terletak di rute /mcp/ dari port yang sama yang digunakan untuk mengakses UI Mainframe Assessment Tool, lihat Mengakses VM Mainframe Assessment Tool dari komputer Anda.

Misalnya, untuk menggunakan Gemini CLI, konfigurasi server MCP di file setelan Gemini CLI sebagai berikut:

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

Ganti kode berikut:

  • LOCAL_PORT: Port lokal yang digunakan untuk mengakses UI Mainframe Assessment Tool.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi server MCP di settings.json.

Alat server MCP

Server MCP Mainframe Assessment Tool menyediakan alat yang memungkinkan agen AI mengambil data dari penilaian Anda.

ListAssessments

Mencantumkan semua penilaian yang ada di instance Mainframe Assessment Tool. Setiap penilaian mencakup nama, ID, deskripsi, dan stempel waktunya.

ListDomains

Mencantumkan domain untuk ID penilaian Mainframe Assessment Tool tertentu. Setiap domain mencakup nama, deskripsi, dan ID-nya.

Argumen

Nama Jenis Wajib Deskripsi
AssessmentId string Ya ID penilaian Mainframe Assessment Tool.

ListAssets

Mencantumkan aset untuk ID penilaian Mainframe Assessment Tool tertentu. Setiap aset mencakup ID, nama, jalur, jenis, dan ID domain yang ditetapkan.

Argumen

Nama Jenis Wajib Deskripsi
AssessmentId string Ya ID penilaian Mainframe Assessment Tool.

FetchDomain

Mengambil detail domain untuk ID domain dan ID penilaian Alat Penilaian Mainframe tertentu. Detail domain mencakup ID, nama, deskripsi, dan ringkasan.

Argumen

Nama Jenis Wajib Deskripsi
AssessmentId string Ya ID penilaian Mainframe Assessment Tool.
DomainId string Ya ID domain Mainframe Assessment Tool.

FetchAsset

Mengambil ringkasan spesifikasi untuk aset untuk ID penilaian Mainframe Assessment Tool tertentu. Spesifikasi aset mencakup ID, nama, penggunaan, deskripsi, grafik ETL, dan peta BMS.

Argumen

Nama Jenis Wajib Deskripsi
AssessmentId string Ya ID penilaian Mainframe Assessment Tool.
AssetId string Ya ID aset Mainframe Assessment Tool.
DetailedSpec boolean Tidak (default: false) Jika disetel ke benar (true), respons juga mencakup spesifikasi metode dengan kasus pengujiannya.

FetchAssetsCyclomaticComplexity

Mengambil skor kompleksitas siklomatik untuk daftar aset untuk ID penilaian Alat Penilaian Mainframe tertentu.

Argumen

Nama Jenis Wajib Deskripsi
AssessmentId string Ya ID penilaian Mainframe Assessment Tool.
AssetIds string[] Ya Daftar ID aset Mainframe Assessment Tool.

Contoh Penggunaan

Berikut adalah contoh perintah bahasa alami yang dapat dijawab agen AI dengan menggunakan alat server MCP untuk mengambil dan memproses data penilaian:

  • Skenario: Temukan program kompleks dalam penilaian.
  • Perintah pengguna: "Buat daftar 10 program COBOL paling kompleks dalam penilaian yang disebut AssessmentName."

  • Skenario: Temukan dan filter aset yang termasuk dalam domain bisnis.
  • Perintah pengguna: "List all the JCL jobs related to the DomainName domain under the assessment called AssessmentName."

  • Skenario: Dapatkan dependensi aset dari penilaian.
  • Perintah pengguna: "Apa saja dependensi tugas JCL JCLJobName dalam penilaian yang disebut AssessmentName?"