Install
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-maps"],لمن يناسب
إذا كان لديك بالفعل مفتاح Google Maps API وتريد في محادثة MCP تحويل عنوان إلى إحداثيات، فهذا الخادم يناسب. يوضح الرسمي أنه MCP Server لواجهة Google Maps API.
لا يناسب البيئات التي بلا مفتاح بعد. يشترط المقتطف إنشاء مفتاح وفق وثائق Google، وعنوانها https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys . اسم متغير الإعداد هو GOOGLE_MAPS_API_KEY؛ املأ مفتاحك ولا تنسخ أي قيمة مثال نائبة.
الأداة الوحيدة المكتوبة بالكامل في المقتطف الحالي هي maps_geocode: الإدخال address (string)، والإرجاع location و formatted_address و place_id. القدرات الأخرى لا تظهر في هذا المقتطف؛ لا تُكمل أسماء أدوات بنفسك. هذه قراءة ترميز جغرافي وما تزال تستدعي Google Maps API؛ لا تفهمها على أنها بلا شبكة ولا حدود خصوصية.
أكمل المحاولة الأولى في 3 دقائق
احصل أولاً على مفتاحك من الوثائق أعلاه. المسار الرئيسي الموصى به رسميًا هو التشغيل بـ npx في إعداد MCP، دون السير إلى Docker بالتوازي:
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-maps"],
في متغيرات بيئة الإعداد نفسه عيّن GOOGLE_MAPS_API_KEY إلى مفتاحك الحقيقي. ضع هذه القطعة في موضع إعداد عميل MCP الذي تستخدمه؛ المقتطف لا يثبّت اسم ملف. احفظ وأعد التحميل.
في المرة الأولى استدعِ maps_geocode فقط، وأدخل سلسلة عنوان تملكها. لا تخترع أسماء معاملات لم تظهر. علامة النجاح هي إرجاع location و formatted_address و place_id، لا رسالة نقص GOOGLE_MAPS_API_KEY أو عجز npx عن تشغيل @modelcontextprotocol/server-google-maps.
حالات الاستخدام
الحالة الأولى: حوّل عنوانًا إلى إحداثيات. يوضح المقتطف أن maps_geocode يُستخدم لـ Convert address to coordinates، والإدخال سلسلة address، والإرجاع يتضمن location. قدّم عنوانك. ما يمكن التحقق منه هو حقل location؛ تفاصيل تنسيق الإحداثيات الإضافية ليست في المقتطف.
الحالة الثانية: من نفس الترميز الجغرافي احصل على عنوان قياسي ومعرّف مكان. يوضح المقتطف أن الإرجاع يشمل أيضًا formatted_address و place_id. عند النجاح يجب أن ترى عنوانًا موحّدًا و place_id، لا مجموعة إحداثيات فقط. ماذا يمكن فعله لاحقًا بهذه الحقول ليس معطى كأداة تالية في المقتطف الحالي، لذا لا تكتب استعلام تفاصيل لم يظهر على أنه مثبت.
تقع الحالتان على maps_geocode، وتأخذان فقط coordinates مقابل formatted_address/place_id. المقتطف الحالي بلا أداة ثانية مسمّاة.
حدود الاستخدام
المسار الرئيسي هو npx -y @modelcontextprotocol/server-google-maps مع تعيين GOOGLE_MAPS_API_KEY. يظهر في المقتطف أيضًا صورة docker run المسماة mcp/google-maps وتحتاج نفس المتغير؛ هذا مسار تثبيت منافس، فلا تستخدمه بالتوازي في المحاولة الأولى.
الصفحة الرسمية هي https://github.com/modelcontextprotocol/servers-archived/tree/main/src/google-maps . ملاحظات إنشاء المفتاح في https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys . لا تكتب مفتاح مثال نائب في الإعداد. لا تُكمل بنفسك أسماء أدوات أو تخطيط مسار أو أرقام حصص لم تظهر.