Server MCP Mainframe Assessment Tool

Halaman ini menjelaskan cara menyiapkan dan berinteraksi dengan penilaian Mainframe Assessment Tool dengan 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. Misalnya, Anda dapat melakukan hal berikut:

  • Mencantumkan dan melihat penilaian yang ada.
  • Mempelajari domain bisnis yang ditemukan dalam penilaian Anda.
  • Menelusuri dan memfilter aset berdasarkan berbagai kriteria.
  • Mengambil spesifikasi aset, termasuk metrik dependensi dan kompleksitas.

Untuk mengetahui informasi selengkapnya tentang MCP, lihat Apa yang dimaksud dengan Model Context Protocol (MCP)?.

Sebelum memulai

Untuk bersiap mengaktifkan dan terhubung ke server MCP, selesaikan tugas berikut:

  • Pelajari Mainframe Assessment Tool. Pastikan Anda telah menggunakan Mainframe Assessment Tool untuk menjalankan penilaian.
  • Berikan izin yang diperlukan. Untuk mengaktifkan server Mainframe Assessment ToolMCP, Anda memerlukan izin untuk menetapkan metadata kustom pada instance VM. Lihat menetapkan dan menghapus metadata kustom untuk mengetahui detail tentang peran dan izin yang diperlukan.
  • Siapkan Google Cloud CLI. Instal dan konfigurasi Google Cloud CLI versi terbaru. Untuk mengetahui informasi selengkapnya, lihat Menginstal Google Cloud CLI.

Mengaktifkan server MCP

Untuk mengaktifkan server MCP di instance VM Mainframe Assessment Tool, 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 menetapkan kunci metadata pada VM yang sedang berjalan, Anda harus memulai ulang VM agar perubahan diterapkan.

Menghubungkan ke server MCP

Anda dapat terhubung ke server MCP menggunakan agen AI standar yang mendukung koneksi MCP melalui HTTP yang Dapat Di-streaming.

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

Contoh konfigurasi

Bagian berikut memberikan contoh cara mengonfigurasi berbagai agen AI untuk terhubung ke server MCP.

Ganti LOCAL_PORT: dengan port lokal yang digunakan untuk mengakses UI Mainframe Assessment Tool.

Gemini CLI

Untuk menggunakan Gemini CLI, konfigurasi server MCP dalam file setelan Gemini CLI sebagai berikut:

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

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 Mainframe Assessment Tool 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 ditetapkan ke true, respons juga akan menyertakan spesifikasi metode dengan kasus pengujiannya.

FetchAssetsCyclomaticComplexity

Mengambil skor kompleksitas siklomatik untuk daftar aset untuk ID penilaian Mainframe Assessment Tool tertentu.

Argumen

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

SearchContent

Menelusuri kode sumber, spesifikasi yang dihasilkan AI, dan aturan bisnis dalam penilaian mainframe tertentu. Alat ini mendukung mode penelusuran berbasis kata kunci (bm25), semantik (embedding), dan hibrida (hybrid), sehingga pengguna dapat menemukan aset dan dokumentasi yang relevan.

Alat ini dapat memfilter hasil menurut jenis dokumen (source, spec, atau bre), membatasi jumlah kecocokan yang ditampilkan, dan secara opsional mengambil konten lengkap dokumen yang cocok.

Argumen

Nama Jenis Wajib Deskripsi
AssessmentId string Ya ID penilaian Mainframe Assessment Tool.
Query string Ya Kueri penelusuran.
DocTypes string[] Tidak Memfilter hasil menurut jenis dokumen. Nilai yang didukung adalah: source, spec, atau bre.
Limit integer Tidak Membatasi jumlah kecocokan yang ditampilkan.
IncludeContent boolean Tidak Jika ditetapkan ke true, respons juga akan menyertakan konten lengkap dokumen yang cocok. Nilai defaultnya adalah false.
SearchMode string Tidak Mode penelusuran yang akan digunakan. Nilai yang didukung adalah: bm25 (berbasis kata kunci), embedding (semantik), atau hybrid. Nilai defaultnya adalah hybrid.

ListBusinessRulesExtractionJobs

Mencantumkan Tugas Aturan Bisnis untuk ID penilaian Mainframe Assessment Tool tertentu. Daftar yang ditampilkan mencakup ID, nama, status, perintah fokus setiap tugas, dan lainnya.

Argumen

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

ListBusinessRules

Mencantumkan Aturan Bisnis yang diekstrak oleh ID tugas ekstraksi aturan bisnis dan ID penilaian Mainframe Assessment Tool tertentu. Untuk menangani sejumlah besar aturan, tindakan ini mendukung penomoran halaman.

Argumen

Nama Jenis Wajib Deskripsi
AssessmentId string Ya ID penilaian Mainframe Assessment Tool.
JobId string Ya ID tugas ekstraksi aturan bisnis.
PageSize string Tidak Ukuran halaman yang akan diambil. Nilai maksimum yang didukung adalah `25`.
PageToken string Tidak Token halaman yang akan diambil. Nilai ini ditampilkan oleh panggilan sebelumnya ke tindakan ini.
OrderList objek Tidak Urutan untuk menampilkan hasil. Lihat deskripsi per kolom.
OrderList.OrderBy string Tidak Nama kolom untuk mengurutkan hasil berdasarkan. Contoh: business_rule_id, business_rule_name, status.
OrderList.Order string Tidak Arah urutan. Nilai yang didukung adalah: ASCENDING, DESCENDING.
Filter objek Tidak Memfilter hasil yang ditampilkan. Lihat deskripsi per kolom.
Filter.Status string Tidak Status aturan bisnis yang akan difilter. Nilai yang didukung adalah: PENDING, VALIDATED, OBSOLETE.
Filter.Tags string[] Tidak Daftar tag yang terkait dengan aturan bisnis.
Filter.AssetIDs string[] Tidak Daftar ID aset Mainframe Assessment Tool yang terkait dengan aturan bisnis.

Contoh Penggunaan

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

  • Skenario: Menemukan program kompleks dalam penilaian.
  • Perintah pengguna: "Cantumkan 10 program COBOL paling kompleks dalam penilaian bernama AssessmentName."

  • Skenario: Menemukan dan memfilter aset yang termasuk dalam domain bisnis.
  • Perintah pengguna: "Cantumkan semua tugas JCL yang terkait dengan domain DomainName dalam penilaian bernama AssessmentName."

  • Skenario: Mendapatkan dependensi aset dari penilaian.
  • Perintah pengguna: "Apa dependensi tugas JCL JCLJobName dalam penilaian bernama AssessmentName?"

  • Skenario: Menemukan aturan bisnis yang diekstrak dari tugas tertentu.
  • Perintah pengguna: "Cantumkan semua aturan bisnis yang diekstrak oleh BusinessRuleJobName dalam penilaian bernama AssessmentName?"