שרת ה-MCP של Mainframe Assessment Tool

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

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

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

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

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

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

הפעלת שרת ה-MCP

כדי להפעיל את שרת ה-MCP במופע של מכונה וירטואלית של 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: האזור שבו נמצא המופע של המכונה הווירטואלית.

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

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

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

שרת ה-MCP נמצא בנתיב /mcp/ של אותה יציאה שמשמשת לגישה לממשק המשתמש של Mainframe Assessment Tool. אפשר לעיין במאמר גישה למכונה וירטואלית של כלי ההערכה של המיינפריים מהמחשב.

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

בקטעים הבאים מופיעות דוגמאות להגדרת סוכני 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 שמשויכים לכללים העסקיים.

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

הנה דוגמאות להנחיות בשפה טבעית שסוכן 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".