תחילת העבודה

גרסה 0.4.0 מספקת 42 כלים בקובץ הפעלה אחד, לשימוש מהמסוף או מלקוח MCP. המדריך מתאר התקנה, הגדרת גישה ל־Google וממשק מלא לכל הכלים.

מתוך עותק המאגר המקומי:

cargo install --path . --locked

התקנה

קובצי הפעלה מוכנים ל-Linux x86_64, macOS Apple Silicon ו-macOS Intel זמינים ב-GitHub Releases. הורידו את הארכיון המתאים, אמתו מול SHA256SUMS, חלצו ומקמו את mcp-gmap-rs ב-PATH. קובצי Linux דורשים glibc 2.35 ומעלה. קובצי macOS אינם חתומים או מאושרי notarization.

עם Rust 1.88 ומעלה, התקינו מ-crates.io:

cargo install mcp-gmap-rs --version 0.4.0 --locked
mcp-gmap-rs --version

לא נדרשת סביבת ריצה של Rust, Python או JavaScript אחרי בניית קובץ ההפעלה. המארח זקוק לתעודות CA, ל-DNS ולגישת HTTPS יוצאת ל-Google.

הגדרת גישה

צרו מפתח מוגבל והפעילו שירותים, או הגדירו OAuth לחשבון שירות. שמרו פרטי גישה בקובץ .env המוחרג מ-Git בתיקיית העבודה:

GOOGLE_MAPS_AUTH_MODE=api-key
GOOGLE_MAPS_API_KEY=your-restricted-api-key

משתני הסביבה גוברים על הקובץ. שמרו פרטי גישה מחוץ לבקרת המקור ולשכבות התמונה. תיקיית העבודה חשובה: אין חיפוש אחר .env בתיקיות אב.

גילוי, בדיקה וקריאה

גילוי ואבחון לא מקוון אינם שולחים בקשות ל-Google:

mcp-gmap-rs tools
mcp-gmap-rs schema search-places
mcp-gmap-rs doctor

לאחר מכן בצעו קריאה ראשונה העשויה להיות כרוכה בתשלום:

mcp-gmap-rs search-places --query 'coffee near Gare de Lyon, Paris'

התוצאה היא JSON. שמרו מזהי מקומות שהוחזרו לפרטים בהמשך במקום לפתור שוב ושוב את אותם שמות. קראו שימוש ב-CLI לאוטומציה או שילוב MCP לחיבור סוכן. המתכונים מראים איך לשלב כלים; המפרט המלא מתעד כל פרמטר, ברירת מחדל ותוצאה.