/ الدليل / الملعب / mcp-google-map
← كل الخوادم ↗ GitHub
● مجتمع cablate ⚡ فوري

mcp-google-map

بواسطة cablate · cablate/mcp-google-map

تحويل العناوين إلى إحداثيات والاتجاهات والأماكن والارتفاع والمناطق الزمنية وحتى الطقس وجودة الهواء — 18 أداة من أدوات Google Maps معروضة على Claude للمهام التي تعتمد على الموقع الجغرافي.

يغلّف mcp-google-map واجهات برمجة Google Places (الجديد) و Routes بالإضافة إلى عدة واجهات برمجية أخرى إلى 14 أداة ذرية و4 أدوات مركبة. تتعامل الأدوات المركبة (explore-area, plan-route, compare-places, local-rank-tracker) مع سير عمل الاستدعاءات المتعددة الشائعة في خطوة واحدة لتوفير الرموز وحصة Google.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

google-map.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "google-map": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-map"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "google-map": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-map"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "google-map": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-map"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "google-map": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-map"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "google-map",
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-map"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "google-map": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-google-map"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add google-map -- npx -y mcp-google-map

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: mcp-google-map

تتبع تصنيفك على خرائط Google للبحث الأساسي عبر أكواد البريد

👤 متخصصو الـ SEO المحلي والمطاعم والشركات الخدمية ⏱ ~20 min intermediate

متى تستخدمه: تريد معرفة مكان تصنيف شركتك للبحث عن 'أفضل بيتزا' في 20 رمز بريد حول المدينة، مع التحديث الأسبوعي.

المتطلبات الأساسية
  • مفتاح Google Maps API مع تفعيل Places (الجديد) — Google Cloud Console > تفعيل الـ APIs
الخطوات
  1. استخدم أداة local-rank-tracker المركبة
    قم بتشغيل local-rank-tracker لشركة 'Tony's Pizza' (place_id: [id]) على الاستعلام 'بيتزا بالقرب مني' عبر هذه الإحداثيات الـ 20 [قائمة lat/lng].✓ تم النسخ
    → التصنيف لكل موقع (أو 'غير موجود في أفضل 20')
  2. حفظ السجل
    احفظ النتائج في ./rank-history/YYYY-MM-DD.json قارنها مع الأسبوع الماضي.✓ تم النسخ
    → الفرق من أسبوع لآخر

النتيجة: تقرير تصنيف محلي أسبوعي دون دفع ثمن أداة SaaS للـ SEO.

المزالق
  • تكاليف واجهة برمجة Google Places تتراكم — ~$17 لكل 1000 استدعاء — جمّع المواقع؛ حدد بأكواد البريد الرئيسية؛ قم بتخزين مؤقت لمدة 7 أيام
اجمعها مع: filesystem

خطط رحلة يومية متعددة المحطات مع وقت القيادة والارتفاع

👤 المسافرون ومدونو السفر ⏱ ~10 min beginner

متى تستخدمه: تخطط رحلة برية وتريد ترتيب المحطات الأمثل + أوقات القيادة الواقعية.

الخطوات
  1. وصف المحطات
    أريد زيارة Yosemite Valley و Mariposa Grove و Tunnel View و Glacier Point — في يوم واحد بدءاً من Merced. حسّن الترتيب وأعطني أوقات القيادة.✓ تم النسخ
    → المحطات المرتبة + دقائق القيادة لكل مرحلة
  2. أضف السياق
    لكل محطة، احصل على الارتفاع والطقس الحالي.✓ تم النسخ
    → برنامج الرحلة المشروح

النتيجة: برنامج سفر معقول مع مدد زمنية حقيقية.

المزالق
  • تستخدم واجهة برمجة Routes تقديرات مدركة للحركة فقط في وقت الاستعلام — أعد الاستعلام في صباح الرحلة للحصول على أوقات قيادة واقعية

قارن المواقع المرشحة لمتجر البيع بالتجزئة الجديد

👤 محللو العقارات ومخططو الامتيازات ⏱ ~30 min intermediate

متى تستخدمه: تقرر بين 3 عناوين مرشحة لواجهة متجر جديدة. تدفق المشاة وقرب المنافسين والمؤشرات الديموغرافية مهمة.

الخطوات
  1. معكوس جيوكود لكل مرشح
    لهذه العناوين الثلاثة، احصل على الإحداثيات والحي.✓ تم النسخ
    → 3 نتائج مجيوكودة
  2. استخدم compare-places
    لكل موقع، عد المنافسين ضمن 1 كم (الفئة: مقهى). اسرد أفضل 10 شركات قريبة.✓ تم النسخ
    → كثافة المنافسة لكل موقع + المستأجرون الرسيون
  3. قيّم ممرات حركة المرور
    لكل منها، احصل على وقت القيادة من أقرب مخرج طريق سريع ورمز بريدي سكني رئيسي.✓ تم النسخ
    → درجة إمكانية الوصول

النتيجة: توصية موقع مدعومة بالبيانات يمكنك الدفاع عنها في الاجتماع.

المزالق
  • Google Places ليست بديلاً لبيانات تدفق المشاة الفعلية — استخدمها كمرشح في المرة الأولى؛ اجمعها مع بيانات Placer.ai أو بيانات تصاريح المقاطعة للقرار النهائي

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

google-map + filesystem

احفظ لقطات local-rank-tracker الأسبوعية على القرص، قارنها عبر الوقت

قم بتشغيل local-rank-tracker لعملي، احفظه في /reports/rank/YYYY-MM-DD.json.✓ تم النسخ
google-map + postgres

أثر عناوين العملاء في قاعدة البيانات الخاصة بك باستخدام lat/lng لوحات خرائط

لكل صف في الجدول customers حيث lat IS NULL، قم بجيوكود العنوان وحدّث باستخدام lat/lng توقف عند 500/يوم احترم الحصة.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
geocode address: str العنوان → الإحداثيات $5 / 1000 calls
reverse_geocode lat, lng الإحداثيات → العنوان $5 / 1000
directions origin, destination, mode?, waypoints? الاتجاهات خطوة بخطوة أو وقت القيادة $5-10 / 1000
places_search query, location?, radius? ابحث عن الشركات حسب الكلمة الرئيسية بالقرب من نقطة $17-32 / 1000 (New Places)
place_details place_id بعد places_search للحصول على الساعات والهاتف والموقع الإلكتروني $17+ / 1000
explore-area center, radius, categories[] مركب — مسح الحي في خطوة واحدة bundled
plan-route stops[], mode, optimize?: bool تخطيط الرحلة متعددة المحطات bundled
compare-places places[], categories[] اختيار الموقع أو التقييم bundled
local-rank-tracker query, place_id, locations[] تدقيق الـ SEO المحلي N * places_search cost

التكلفة والحدود

تكلفة التشغيل

حصة API
Google: رصيد مجاني بقيمة $200/شهر يغطي ~12 ألف geocode أو ~10 آلاف Places (الجديد) Autocomplete/Details
الرموز لكل استدعاء
نتائج الأداة 500-3000 رمز؛ قلّصها عبر GOOGLE_MAPS_ENABLED_TOOLS لتقليل تكلفة المخطط
التكلفة المالية
ادفع مباشرة لـ Google انظر cloud.google.com/maps-platform/pricing.
نصيحة
Places (الجديد) هو الأغلى ثمناً استخدم geocode (رخيص) عندما تحتاج فقط إلى الإحداثيات وليس بيانات العمل قم بتخزين place_id بقوة.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: قم بتفعيل فقط واجهات البرمجة التي تستخدمها فعلاً
تخزين بيانات الاعتماد: متغير بيئة GOOGLE_MAPS_API_KEY قيّد المفتاح إلى عنوان IP / المحيل الخاص بك.
نقل البيانات الخارجي: جميع الاستعلامات إلى maps.googleapis.com
لا تمنح أبدًا: مفتاح غير مقيد على جهاز مشترك — يمكن لأي شخص أن يحرق حصتك

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

REQUEST_DENIED / API key not valid

لم يتم تفعيل واجهة البرمجة أو قيود المفتاح تحجب عنوان IP الخاص بك. تحقق من GCP Console > APIs & Services > Credentials.

تحقق: curl 'https://maps.googleapis.com/maps/api/geocode/json?address=NYC&key=$KEY'
OVER_QUERY_LIMIT

لقد استهلكت الحد الشهري المجاني البالغ $200، أو أن Google تقيد الطلبات في الثانية. تراجع وجمّع المتطلبات.

تحقق: GCP Billing > التقارير
Empty results for obvious queries

يتطلب Places (الجديد) أقنعة حقول صريحة في بعض الاستدعاءات. حدّث إلى أحدث إصدار npm.

البدائل

mcp-google-map مقابل البدائل

البديلمتى تستخدمهاالمقايضة
OpenStreetMap Nominatim MCPمجاني بدون الحاجة إلى مفتاح API الاستخدام غير التجاري مسموحبيانات أقل ثراءً؛ محدود بمعدل 1 rps
Mapbox MCPتفضل تصميم وتوجيه Mapboxتسعير ونموذج بيانات مختلفان

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills