במדריך הזה מוסבר איך להשתמש ב-MCP Toolbox for Databases כדי לקשר את Cloud Healthcare API למגוון סביבות פיתוח משולבות (IDE) ולכלי פיתוח. הוא משתמש ב-Model Context Protocol (MCP), פרוטוקול פתוח לחיבור מודלים גדולים של שפה (LLM) למקורות נתונים כמו מערכי נתונים של שירותי בריאות, שמאפשר לכם לחפש נתונים של שירותי בריאות ולקיים אינטראקציה איתם ישירות מהכלים הקיימים שלכם.
במדריך הזה מוצג תהליך החיבור של סביבות הפיתוח המשולבות (IDE) הבאות:
- סמן
- Windsurf (לשעבר Codeium)
- קוד Visual Studio (Copilot)
- Cline (תוסף ל-VS Code)
- Claude למחשב
- Claude code
לפני שמתחילים
בדף project selector במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.
מגדירים את התפקידים וההרשאות הנדרשים כדי לבצע את המשימה הזו. כדי להתחבר לפרויקט, תצטרכו את התפקיד Healthcare FHIR Resource Reader (
roles/healthcare.fhirResourceReader) ואת התפקיד Healthcare DICOM Viewer (roles/healthcare.dicomViewer), או הרשאות IAM שוות ערך.מגדירים Application Default Credentials (ADC) לסביבה שלכם.
התקנת MCP Toolbox
ערכת הכלים פועלת כשרת Model Context Protocol (MCP) בקוד פתוח, שממוקם בין סביבת הפיתוח המשולבת (IDE) לבין Cloud Healthcare API. היא מספקת מישור בקרה מאובטח ויעיל לכלי ה-AI שלכם.
מורידים את הגרסה האחרונה של MCP Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה (OS) ולארכיטקטורת המעבד. חובה להשתמש בגרסה v0.19.1 ואילך של MCP Toolbox:
linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox
מחליפים את
VERSIONבגרסה של MCP Toolbox, לדוגמהv0.19.1.macOS darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox
מחליפים את
VERSIONבגרסה של MCP Toolbox, לדוגמהv0.19.1.macOS darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox
מחליפים את
VERSIONבגרסה של MCP Toolbox, לדוגמהv0.19.1.windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox
מחליפים את
VERSIONבגרסה של MCP Toolbox, לדוגמהv0.19.1.הופכים את הקובץ הבינארי לקובץ הפעלה:
chmod +x toolboxמאמתים את ההתקנה:
./toolbox --version
הגדרת לקוחות וחיבורים
בקטע הזה מוסבר איך לחבר את Cloud Healthcare API לכלים שלכם.
Claude code
- מתקינים את Claude Code.
- יוצרים קובץ
.mcp.jsonבתיקיית הבסיס של הפרויקט, אם הוא לא קיים. - מוסיפים את ההגדרה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } } - מפעילים מחדש את Claude Code כדי לטעון את ההגדרות החדשות. כשפותחים אותו מחדש, הכלי מציין ששרת ה-MCP שהוגדר זוהה.
Claude למחשב
- פותחים את Claude Desktop ועוברים אל Settings (הגדרות).
- בכרטיסייה Developer (פיתוח), לוחצים על Edit Config (עריכת ההגדרה) כדי לפתוח את קובץ ההגדרות.
- מוסיפים את ההגדרה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } } - מפעילים מחדש את Claude Desktop.
- במסך הצ'אט החדש מוצג סמל של פטיש (MCP) עם שרת ה-MCP החדש.
קלין
- פותחים את התוסף Cline ב-VS Code ומקישים על הסמל MCP Servers.
- לוחצים על Configure MCP Servers (הגדרת שרתי MCP) כדי לפתוח את קובץ ההגדרות.
- מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } }
אחרי שהשרת מתחבר בהצלחה, מופיע סטטוס פעיל בצבע ירוק.
סמן
- יוצרים את הספרייה
.cursorבתיקיית הבסיס של הפרויקט אם היא לא קיימת. - יוצרים את הקובץ
.cursor/mcp.jsonאם הוא לא קיים ופותחים אותו. - מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } } - פותחים את הסמן ועוברים אל הגדרות > הגדרות הסמן > MCP. סטטוס פעיל ירוק מופיע כשהשרת מתחבר.
קוד Visual Studio (Copilot)
- פותחים את VS Code ויוצרים את הספרייה
.vscodeבתיקיית הבסיס של הפרויקט, אם היא לא קיימת. - יוצרים את הקובץ
.vscode/mcp.jsonאם הוא לא קיים, ופותחים אותו. - מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "servers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } } - טוענים מחדש את החלון של VS Code. התוסף שתואם ל-MCP מזהה באופן אוטומטי את ההגדרה ומתחיל את השרת.
גלישת רוח
- פותחים את Windsurf ועוברים אל Cascade assistant.
- לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ ההגדרות.
- מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } }
הערה: משתנה הסביבה
HEALTHCARE_PROJECTמציין את מזהה הפרויקט שבו כלי MCP Toolbox ישתמש כברירת מחדל. Google Cloud כל הפעולות, כמו חיפוש מטופלים או חיפוש מופעי DICOM, מבוצעות במסגרת הפרויקט הזה.
שימוש בכלים
כלי ה-AI שלכם מחובר עכשיו ל-Cloud Healthcare API באמצעות MCP. אפשר לבקש מהעוזר הדיגיטלי מבוסס ה-AI לחפש מטופלים ב-FHIR, לאחזר רשומות של מטופל מסוים, לחפש מחקר DICOM או להציג רשימה של מאגרי DICOM במערך הנתונים.
הכלים הבאים זמינים ל-LLM:
- get_dataset: אחזור של פרטי מערך נתונים.
- list_datasets: הצגת רשימה של מערכי נתונים של מידע רפואי בפרויקט.
- list_fhir_stores: הצגת רשימה של מאגרי FHIR במערך הנתונים הנתון.
- list_dicom_stores: הצגת רשימה של חנויות DICOM במערך הנתונים הנתון.
- get_fhir_store: מקבל את ההגדרה של מאגר FHIR שצוין.
- get_fhir_store_metrics: מקבל מדדים שמשויכים למאגר FHIR.
- get_fhir_resource: מקבל את התוכן של משאב FHIR.
- get_fhir_resource_version: מקבל את התוכן של גרסה (נוכחית או היסטורית) של משאב FHIR.
- fhir_patient_everything: מאחזר משאב של מטופל FHIR ומשאבים שקשורים למטופל הזה.
- fhir_patient_search: חיפוש משאבי מטופלים ב-FHIR בחנות FHIR לפי קריטריונים שצוינו.
- get_dicom_store: מקבל את ההגדרה של מאגר DICOM שצוין.
- get_dicom_store_metrics: מקבל מדדים שמשויכים למאגר DICOM.
- search_dicom_studies: מחזירה רשימה של מחקרים תואמים בפורמט DICOM.
- search_dicom_series: מחזירה רשימה של סדרות DICOM תואמות.
- search_dicom_instances: מחזירה רשימה של מופעי DICOM שתואמים לקריטריונים.
- retrieve_dicom_instance_rendered: מחזירה קידוד base64 של תמונה שעברה רינדור בפורמט JPEG עבור מופע DICOM שמשויך למחקר, לסדרה ול-SOP Instance UID שצוינו.