הפעלת שרת ה-MCP של Mainframe Assessment Tool

בדף הזה מוסבר איך להגדיר את שרת MCP של Mainframe Assessment Tool ואיך ליצור איתו אינטראקציה. אתם יכולים לחקור דומיינים עסקיים, לחפש נכסים ולאחזר מדדי מורכבות מההערכות של המחשב המרכזי באמצעות הנחיות בשפה טבעית. כדי ליצור אינטראקציה עם שרת ה-MCP, מתחברים דרך סוכני AI או לקוחות Model Context Protocol‏ (MCP), כמו Gemini CLI.

לדוגמה, אתם יכולים:

  • הצגת רשימה של הערכות קיימות.
  • עיון בדומיינים עסקיים שנמצאו בהערכות.
  • חיפוש וסינון של נכסים על סמך קריטריונים שונים.
  • אחזור דרישות לגבי נכסים, כולל יחסי תלות ומדדי מורכבות.

מידע נוסף על MCP זמין במאמר מהו Model Context Protocol‏ (MCP)?

לפני שמתחילים

כדי להתכונן להפעלה ולחיבור לשרת ה-MCP, צריך לבצע את המשימות הבאות:

  • כדאי להכיר את Mainframe Assessment Tool ולוודא שכבר השתמשתם בו כדי להריץ הערכה.
  • נותנים את ההרשאות הנדרשות. ההרשאות שאתם צריכים תלויות באופן שבו פרסתם את Mainframe Assessment Tool:
  • מגדירים את Google Cloud CLI.מתקינים ומגדירים את הגרסה האחרונה של Google Cloud CLI. מידע נוסף זמין במאמר התקנת Google Cloud CLI.

הפעלת שרת ה-MCP

שרת ה-MCP מושבת כברירת מחדל. כדי להפעיל את שרת ה-MCP, פועלים לפי ההוראות לסביבת הפריסה.

במכונה של Compute Engine

כדי להפעיל את שרת ה-MCP במכונת Compute Engine של Mainframe Assessment Tool, מוסיפים את מפתח המטא-נתונים MAT_ENABLE_MCP ומגדירים את הערך שלו ל-true על ידי הפעלת הפקודה gcloud הבאה:

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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫INSTANCE_NAME: השם של מופע מכונת ה-VM.
  • ‫ZONE: האזור שבו נמצא המופע של המכונה הווירטואלית.

אם מגדירים את מפתח המטא-נתונים במכונה וירטואלית פועלת, צריך להפעיל מחדש את המכונה הווירטואלית כדי שהשינויים ייכנסו לתוקף.

באשכול GKE

כדי להפעיל את שרת ה-MCP בפריסת GKE, צריך להגדיר את משתנה הסביבה MAT_ENABLE_MCP במאגר mcp-server לערך true:

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

מחליפים את VERSION בגרסה של Mainframe Assessment Tool שנפרסה באשכול. הגרסה הזו היא גם מרחב השמות של הפריסה (לדוגמה, mainframe-assessment-2-8-0). עדכון של משתנה הסביבה מפעיל מחדש את ה-pod של Mainframe Assessment Tool עם שרת ה-MCP. הכלי Mainframe Assessment Tool פועל כ-pod יחיד, ולכן הוא לא זמין לזמן קצר בזמן שה-pod החדש מתחיל לפעול. כדי להשבית את שרת ה-MCP, מגדירים את משתנה הסביבה MAT_ENABLE_MCP לערך false.

חיבור לשרת ה-MCP

אפשר להתחבר לשרת ה-MCP באמצעות סוכני AI רגילים שתומכים בחיבורי MCP דרך HTTP ניתן להזרמה.

שרת ה-MCP ממוקם בנתיב ‎ /mcp/ ‎ באותה יציאה שמשמשת לגישה לממשק המשתמש של Mainframe Assessment Tool. מידע נוסף זמין במאמרים גישה ל-VM של Mainframe Assessment Tool מהמחשב שלכם או גישה ל-Mainframe Assessment Tool שפריסתו בוצעה ב-GKE מהמחשב שלכם.

תצורות לדוגמה

בקטעים הבאים מופיעות דוגמאות להגדרת סוכני AI שונים לחיבור לשרת ה-MCP.

מחליפים את LOCAL_PORT: ביציאה המקומית שמשמשת לגישה לממשק המשתמש של Mainframe Assessment Tool.

Gemini CLI

כדי להשתמש ב-Gemini CLI, צריך להגדיר את שרת ה-MCP בקובץ ההגדרות של Gemini CLI באופן הבא:

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

מידע נוסף זמין במאמר הגדרת שרת MCP בקובץ settings.json.

כלים של שרת ה-MCP

שרת ה-MCP של Mainframe Assessment Tool מספק כלים שמאפשרים לסוכני AI לאחזר נתונים מההערכות שלכם.

ListAssessments

מציג רשימה של כל ההערכות במופע של Mainframe Assessment Tool. כל הערכה כוללת את השם, המזהה, התיאור וחתימות הזמן שלה.

ListDomains

מפרטת את הדומיינים של מזהה הערכה נתון של Mainframe Assessment Tool. כל דומיין כולל את השם, התיאור והמזהה שלו.

ארגומנטים

שם סוג חובה תיאור
AssessmentId מחרוזת כן המזהה של ההערכה בכלי Mainframe Assessment Tool.

ListAssets

רשימת הנכסים של מזהה הערכה מסוים של Mainframe Assessment Tool. כל נכס כולל את המזהה, השם, הנתיב, הסוג ומזהי הדומיין שהוקצו לו.

ארגומנטים

שם סוג חובה תיאור
AssessmentId מחרוזת כן המזהה של ההערכה בכלי Mainframe Assessment Tool.

FetchDomain

מאחזר את פרטי הדומיין עבור מזהה דומיין ומזהה הערכה של Mainframe Assessment Tool. פרטי הדומיין כוללים מזהה, שם, תיאור וסיכום.

ארגומנטים

שם סוג חובה תיאור
AssessmentId מחרוזת כן המזהה של ההערכה בכלי Mainframe Assessment Tool.
DomainId מחרוזת כן המזהה של הדומיין של Mainframe Assessment Tool.

FetchAsset

מאחזרת את סיכום המפרט של נכס לפי מזהה הערכה ספציפי של Mainframe Assessment Tool. מפרט הנכס כולל את המזהה, השם, השימוש, התיאור, תרשים ה-ETL ומפות ה-BMS.

ארגומנטים

שם סוג חובה תיאור
AssessmentId מחרוזת כן המזהה של ההערכה בכלי Mainframe Assessment Tool.
AssetId מחרוזת כן המזהה של הנכס Mainframe Assessment Tool.
DetailedSpec בוליאני לא (ברירת מחדל: false) אם הערך מוגדר כ-true, התשובה כוללת גם מפרטים של שיטות עם תרחישי הבדיקה שלהן.

FetchAssetsCyclomaticComplexity

מאחזר את ציוני המורכבות הציקלומטית של רשימת נכסים לפי מזהה הערכה של Mainframe Assessment Tool.

ארגומנטים

שם סוג חובה תיאור
AssessmentId מחרוזת כן המזהה של ההערכה בכלי Mainframe Assessment Tool.
AssetIds string[] כן רשימה של מזהי נכסים של Mainframe Assessment Tool.

SearchContent

חיפושים בקוד מקור, במפרטים שנוצרו על ידי AI ובכללים עסקיים במסגרת הערכה ספציפית של מחשב מרכזי. הוא תומך במצבי חיפוש מבוססי מילות מפתח (bm25), סמנטיים (embedding) והיברידיים (hybrid), ומאפשר למשתמשים לאתר נכסים ומסמכים רלוונטיים.

הכלי יכול לסנן את התוצאות לפי סוג המסמך (source,‏ spec או bre), להגביל את מספר ההתאמות שמוחזרות, ובאופן אופציונלי לאחזר את התוכן המלא של מסמכים תואמים.

ארגומנטים

שם סוג חובה תיאור
AssessmentId מחרוזת כן המזהה של ההערכה בכלי Mainframe Assessment Tool.
Query מחרוזת כן שאילתת החיפוש.
DocTypes string[] לא סינון התוצאות לפי סוג המסמך. הערכים הנתמכים הם: source,‏ spec או bre.
Limit מספר שלם לא הגבלת מספר ההתאמות שמוחזרות.
IncludeContent בוליאני לא אם הערך הוא true, התשובה כוללת גם את התוכן המלא של המסמכים התואמים. ערך ברירת המחדל הוא false.
SearchMode מחרוזת לא מצב החיפוש שבו רוצים להשתמש. הערכים הנתמכים הם: bm25 (מבוסס על מילות מפתח), embedding (סמנטי) או hybrid. ערך ברירת המחדל הוא hybrid.

ExploreData

מריץ סוכן AI אינטראקטיבי (הכלי לניתוח נתונים) שפועל כמנתח נתונים עבור ההערכה שלך. הסוכן יכול להריץ שאילתות במסד הנתונים המובנה של הערכה ספציפית כדי לענות על שאלות מורכבות.

ארגומנטים

שם סוג חובה תיאור
AssessmentId מחרוזת כן המזהה של ההערכה בכלי Mainframe Assessment Tool.
Query מחרוזת כן השאלה או השאילתה לחיפוש נתונים.

ListBusinessRulesExtractionJobs

מציג את המשימות של כללי העסקים עבור מזהה הערכה נתון של Mainframe Assessment Tool. הרשימה שמוחזרת כוללת את המזהה, השם, הסטטוס, הנחיית המיקוד ועוד של כל משימה.

ארגומנטים

שם סוג חובה תיאור
AssessmentId מחרוזת כן המזהה של ההערכה בכלי Mainframe Assessment Tool.

ListBusinessRules

מציג את הכללים העסקיים שחולצו על ידי מזהה ספציפי של משימת חילוץ כללים עסקיים ומזהה הערכה של Mainframe Assessment Tool. כדי לטפל במספר הגדול של הכללים, הפעולה הזו תומכת בחלוקה לעמודים.

ארגומנטים

שם סוג חובה תיאור
AssessmentId מחרוזת כן המזהה של ההערכה בכלי Mainframe Assessment Tool.
JobId מחרוזת כן המזהה של עבודת החילוץ של הכללים העסקיים.
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 string[] לא רשימת התגים שמשויכים לכללים העסקיים.
Filter.AssetIDs string[] לא רשימה של מזהי נכסים של Mainframe Assessment Tool שמשויכים לכללים העסקיים.

FetchJobSpec

מאחזר את מפרט משימת החילוץ של כללי העסק (BRE) עבור מזהה הערכה של Mainframe Assessment Tool.

ארגומנטים

שם סוג חובה תיאור
AssessmentId מחרוזת כן המזהה של ההערכה בכלי Mainframe Assessment Tool.
JobId מחרוזת כן המזהה של עבודת החילוץ של כללי העסק (BRE).

דוגמאות לשימוש

הנה דוגמאות להנחיות בשפה טבעית שסוכן AI יכול לענות עליהן באמצעות הכלים של שרת MCP כדי לאחזר ולעבד נתוני הערכה:

  • תרחיש: איתור תוכניות מורכבות בהערכה.
  • הנחיית משתמש: "תפרט את 10 התוכניות הכי מורכבות של COBOL בהערכה שנקראת AssessmentName".

  • תרחיש: חיפוש וסינון של נכסים ששייכים לדומיין עסקי.
  • הנחיית משתמש: "תציג רשימה של כל עבודות ה-JCL שקשורות לדומיין DomainName בהערכה שנקראת AssessmentName".

  • תרחיש: קבלת תלות בנכסים מהערכה.
  • הנחיה למשתמש: "What are the dependencies of the JCL job JCLJobName in the assessment called AssessmentName?"

  • תרחיש: חיפוש הכללים העסקיים שחולצו ממשרה מסוימת.
  • הנחיית משתמש: "List all business rules extracted by BusinessRuleJobName in the assessment called AssessmentName."

  • תרחיש: חיפוש נתונים של הערכות באמצעות שפה טבעית.
  • הנחיה למשתמש: "תסביר איך פועל תהליך עיבוד הנתונים במערכת החיוב בהערכה שנקראת AssessmentName".