Mengaktifkan server MCP Mainframe Assessment Tool

Halaman ini menjelaskan cara menyiapkan dan berinteraksi dengan server MCP Mainframe Assessment Tool. Anda dapat menjelajahi domain bisnis, menelusuri aset, dan mengambil metrik kompleksitas dari penilaian mainframe menggunakan perintah bahasa alami. Untuk berinteraksi dengan server MCP, hubungkan melalui agen AI atau klien Model Context Protocol (MCP), seperti Gemini CLI.

Misalnya, Anda dapat melakukan hal berikut:

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

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

Sebelum memulai

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

  • Pahami Mainframe Assessment Tool. Pastikan Anda telah menggunakan Mainframe Assessment Tool untuk menjalankan penilaian.
  • Berikan izin yang diperlukan. Untuk mengaktifkan server MCP Mainframe Assessment Tool, 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 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.

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 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 di 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 pada 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 disetel ke benar (true), respons juga akan menyertakan 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.

SearchContent

Penelusuran di seluruh kode sumber, spesifikasi buatan AI, dan aturan bisnis dalam penilaian mainframe tertentu. Fitur ini mendukung mode penelusuran berbasis kata kunci (bm25), semantik (embedding), dan campuran (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 disetel ke benar (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.

ExploreData

Menjalankan agen AI interaktif (Penjelajah Data) yang bertindak sebagai analis data untuk penilaian Anda. Agen dapat membuat kueri database terstruktur yang mendasar dari penilaian tertentu untuk menjawab pertanyaan yang kompleks.

Argumen

Nama Jenis Wajib Deskripsi
AssessmentId string Ya ID penilaian Mainframe Assessment Tool.
Query string Ya Pertanyaan atau kueri untuk eksplorasi data.

ListBusinessRulesExtractionJobs

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

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 tertentu dan ID penilaian Alat Penilaian Mainframe. 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 pesanan. 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 alami yang dapat dijawab agen AI dengan menggunakan alat server MCP untuk mengambil dan memproses data penilaian:

  • Skenario: Menemukan program yang 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: "Buat daftar semua tugas JCL yang terkait dengan domain DomainName dalam penilaian yang disebut AssessmentName."

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

  • Skenario: Temukan aturan bisnis yang diekstrak dari tugas tertentu.
  • Perintah pengguna: "List all business rules extracted by BusinessRuleJobName in the assessment called AssessmentName." (Buat daftar semua aturan bisnis yang diekstrak oleh BusinessRuleJobName dalam penilaian yang disebut AssessmentName).

  • Skenario: Jelajahi data penilaian menggunakan bahasa alami.
  • Perintah pengguna: "Jelaskan cara kerja alur pemrosesan data untuk sistem penagihan dalam penilaian yang disebut AssessmentName."