البداية

يوفر الإصدار 0.4.0 عدد 42 أداة في ملف تنفيذي واحد، يمكن استخدامها من الطرفية أو عميل MCP. يشرح هذا الدليل التثبيت والوصول إلى Google وواجهة الأدوات كاملةً.

من دليل نسخة المستودع المحلية:

cargo install --path . --locked

التثبيت

تتوفر ملفات جاهزة لـ Linux x86_64 وmacOS Apple Silicon وmacOS Intel في إصدارات GitHub. نزّل أرشيف جهازك، وتحقق منه باستخدام SHA256SUMS، وفكّه وضع mcp-gmap-rs على PATH. تستهدف ملفات Linux الإصدار glibc 2.35 أو أحدث. ملفات macOS غير موقعة ولا موثقة من Apple.

باستخدام 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 لتوصيل وكيل. توضح الوصفات الجمع بين الأدوات؛ ويوثق المرجع الكامل كل معامل وقيمة افتراضية ونتيجة.