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 Antigravity.

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 dependensi dan metrik kompleksitas.

Untuk mengetahui informasi selengkapnya tentang MCP, lihat artikel Apa yang dimaksud dengan 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. Izin yang Anda perlukan bergantung pada cara Anda men-deploy Mainframe Assessment Tool:
    • Di instance VM Compute Engine, Anda memerlukan izin untuk menyetel metadata kustom pada instance. Untuk mengetahui detail tentang peran yang diperlukan, lihat Menetapkan dan menghapus metadata kustom.
    • Di cluster GKE, Anda memerlukan izin untuk memperbarui deployment di cluster, dan Anda harus mengonfigurasi alat command line kubectl untuk terhubung ke cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi akses cluster untuk kubectl.
  • Siapkan Google Cloud CLI. Instal dan konfigurasi Google Cloud CLI versi terbaru. Untuk mengetahui informasi selengkapnya, lihat Menginstal Google Cloud CLI.

Mengaktifkan server MCP

Server MCP dinonaktifkan secara default. Untuk mengaktifkan server MCP, ikuti petunjuk untuk lingkungan deployment Anda.

Di instance Compute Engine

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

Di cluster GKE

Untuk mengaktifkan server MCP pada deployment GKE, tetapkan variabel lingkungan MAT_ENABLE_MCP pada container mcp-server ke true:

kubectl set env deployment/mat-apps --containers=mcp-server \
    MAT_ENABLE_MCP=true --namespace=VERSION

Ganti VERSION dengan versi Mainframe Assessment Tool yang di-deploy di cluster. Versi ini juga merupakan namespace deployment (misalnya, mainframe-assessment-2-8-0). Memperbarui variabel lingkungan akan memulai ulang pod Mainframe Assessment Tool dengan server MCP diaktifkan. Karena Mainframe Assessment Tool berjalan sebagai satu pod, alat ini tidak tersedia sebentar saat pod baru dimulai. Untuk menonaktifkan server MCP, tetapkan variabel lingkungan MAT_ENABLE_MCP ke false.

Hubungkan 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/ pada port yang sama yang digunakan untuk mengakses UI Alat Penilaian Mainframe. Untuk mengetahui informasi selengkapnya, lihat Mengakses VM Mainframe Assessment Tool dari komputer Anda atau Mengakses Mainframe Assessment Tool yang di-deploy di GKE 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.

Antigravity

Untuk menggunakan Antigravity, konfigurasi server MCP di file mcp_config.json sebagai berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Model Context Protocol (MCP).

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 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

Penelusuran di seluruh kode sumber, spesifikasi yang dihasilkan AI, dan aturan bisnis dalam penilaian mainframe tertentu. Fitur 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 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 pekerjaan ekstraksi aturan bisnis tertentu dan ID penilaian Mainframe Assessment Tool. 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.

FetchJobSpec

Mengambil spesifikasi tugas ekstraksi aturan bisnis (BRE) untuk ID penilaian Mainframe Assessment Tool.

Argumen

Nama Jenis Wajib Deskripsi
AssessmentId string Ya ID penilaian Mainframe Assessment Tool.
JobId string Ya ID tugas ekstraksi aturan bisnis (BRE).

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: "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."