Mapbox

Mapbox MCP सर्वर

Mapbox APIs के लिए मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) लागू करने वाला Node.js सर्वर।

अपने AI अनुप्रयोगों के लिए भू-स्थानिक बुद्धिमत्ता अनलॉक करें

Mapbox MCP सर्वर किसी भी AI एजेंट या अनुप्रयोग को भू-स्थानिक रूप से जागरूक प्रणाली में बदल देता है, जो Mapbox के व्यापक स्थान-खुफिया प्लेटफ़ॉर्म तक निर्बाध पहुँच प्रदान करता है। इस सर्वर के साथ, आपका AI स्थानों को समझ और तर्क कर सकता है, भौतिक दुनिया में नेविगेट कर सकता है, और समृद्ध भू-स्थानिक डेटा तक पहुँच सकता है, जिसमें शामिल हैं:

• वैश्विक जियोकोडिंग पते और स्थान के नामों को निर्देशांक में और इसके विपरीत परिवर्तित करने के लिए
• रुचि के बिंदु (POI) खोज दुनिया भर के लाखों व्यवसायों, स्थलों और स्थानों में
• मल्टी-मोडल रूटिंग वास्तविक समय यातायात के साथ ड्राइविंग, पैदल चलने और साइकिल चलाने के लिए
• यात्रा समय मैट्रिक्स पहुँच का विश्लेषण करने और लॉजिस्टिक्स को अनुकूलित करने के लिए
• मार्ग अनुकूलन कई पड़ावों के लिए इष्टतम भ्रमण क्रम खोजने के लिए (ट्रैवलिंग सेल्समैन समस्या)
• मैप मैचिंग साफ मार्ग विज़ुअलाइज़ेशन के लिए GPS ट्रेस को सड़क नेटवर्क पर स्नैप करने के लिए
• आइसोक्रोन निर्माण विशिष्ट समय या दूरी की बाधाओं के भीतर पहुँच योग्य क्षेत्रों को विज़ुअलाइज़ करने के लिए
• लाइव, इंटरैक्टिव मैप रेंडरिंग (render_map_tool) चैट के भीतर सीधे वास्तविक Mapbox GL JS मानचित्र पर मार्ग, खोज परिणाम और आपका अपना कस्टम GeoJSON प्रदर्शित करने के लिए
• स्थिर मानचित्र छवियाँ स्थानों, मार्गों और भौगोलिक डेटा के दृश्य प्रतिनिधित्व बनाने के लिए
• ऑफ़लाइन भू-स्थानिक गणना दूरी, क्षेत्र, बियरिंग, बफर और स्थानिक विश्लेषण के लिए बिना API कॉल की आवश्यकता के

चाहे आप एक AI यात्रा सहायक, लॉजिस्टिक्स ऑप्टिमाइज़र, स्थान-आधारित अनुशंसाकर्ता, या कोई भी अनुप्रयोग बना रहे हों जिसे "कहाँ" समझने की आवश्यकता है, Mapbox MCP सर्वर इसे संभव बनाने के लिए स्थानिक बुद्धिमत्ता प्रदान करता है। आप इसे Claude Desktop और VS Code जैसे लोकप्रिय क्लाइंट पर भी सक्षम कर सकते हैं। विवरण के लिए नीचे देखें।

उपयोग

इस MCP सर्वर का उपयोग करने के लिए Mapbox एक्सेस टोकन आवश्यक है।

होस्टेड MCP एंडपॉइंट

त्वरित पहुँच के लिए, आप हमारे होस्टेड MCP एंडपॉइंट का उपयोग कर सकते हैं:

एंडपॉइंट: https://mcp.mapbox.com/mcp

विभिन्न क्लाइंट और API उपयोग के लिए विस्तृत सेटअप निर्देशों के लिए, होस्टेड MCP सर्वर गाइड देखें।

Mapbox एक्सेस टोकन प्राप्त करने के लिए:

1. mapbox.com/signup पर मुफ्त Mapbox खाते के लिए साइन अप करें
2. अपने खाता पृष्ठ पर नेविगेट करें
3. एक नया टोकन बनाएं या डिफ़ॉल्ट सार्वजनिक टोकन का उपयोग करें

Mapbox एक्सेस टोकन के बारे में अधिक जानकारी के लिए, एक्सेस टोकन पर Mapbox दस्तावेज़ीकरण देखें।

एकीकरण गाइड

विभिन्न एकीकरणों के लिए विस्तृत सेटअप निर्देशों के लिए, निम्नलिखित गाइड देखें:

• Claude Desktop सेटअप - इस MCP सर्वर के साथ काम करने के लिए Claude Desktop को कॉन्फ़िगर करने के निर्देश
• Goose सेटअप - Goose AI एजेंट फ्रेमवर्क सेट करना
• VS Code सेटअप - Visual Studio Code में विकास वातावरण सेट करना
• Cursor AI IDE सेटअप - Cursor AI IDE में विकास वातावरण सेट करना
• Smolagents एकीकरण - Smolagents AI एजेंटों को Mapbox के टूल से जोड़ने का उदाहरण
• टूल सीधे आयात करना - MCP सर्वर चलाए बिना अपने स्वयं के अनुप्रयोगों में Mapbox टूल का उपयोग करें
• render_map_tool गाइड - मानचित्र विज़ुअलाइज़ेशन प्रिमिटिव: पूर्ण पेलोड स्कीमा और किसी अन्य Mapbox टूल के बिना अपना डेटा स्टैंडअलोन कैसे रेंडर करें
• Elicitations - कैसे search_and_geocode_tool और directions_tool उपयोगकर्ता से परिणामों को स्पष्ट करने या मार्ग चुनने के लिए पूछते हैं, और जब क्लाइंट इसका समर्थन नहीं करता है तो वे कैसे सुंदर ढंग से फॉलबैक करते हैं

उदाहरण प्रॉम्प्ट

सेटअप के बाद इन प्रॉम्प्ट को Claude Desktop या अन्य MCP क्लाइंट के साथ आज़माएं:

स्थान ग्राउंडिंग

निर्देशांक-प्रथम क्वेरी के लिए — "मेरे पास क्या है", "यह कौन सा पड़ोस है", "N मिनट में क्या पहुँचा जा सकता है" — ground_location_tool का उपयोग करें। यह एक ही कॉल में रिवर्स जियोकोडिंग, श्रेणी खोज और आइसोक्रोन को संयोजित करता है, क्वेरी के आधार पर सही रणनीति को अनुकूल रूप से चुनता है, और उद्धरणों के साथ टाइप किए गए रिकॉर्ड (नाम, पते, निर्देशांक, दूरियाँ, पहुँच बहुभुज) लौटाता है।

नीचे दिए गए चार प्रॉम्प्ट में से प्रत्येक एक टूल कॉल में एक अलग रणनीति का अभ्यास करता है:

• पड़ोस — "47.6097, -122.3408 कौन सा पड़ोस है, और मेरे आसपास क्या है?"
• POI — "40.7580, -73.9855 से 10 मिनट की पैदल दूरी के भीतर कॉफी शॉप"
• क्षेत्र — "37.7749, -122.4194 से 15 मिनट की पैदल दूरी में मैं क्या पहुँच सकता हूँ?"
• रूटिंग — "34.0522, -118.2437 पर किसी को छोड़ने के लिए निकटतम रूटेबल बिंदु"

स्थान खोज

• "एम्पायर स्टेट बिल्डिंग की पैदल दूरी के भीतर कॉफी शॉप खोजें"
• "मैं सिएटल से पोर्टलैंड जाना चाहता हूँ, क्या रास्ते में कोई Starbucks है?"
• "बोस्टन से न्यूयॉर्क के मार्ग पर गैस स्टेशन दिखाएं"
• "टाइम्स स्क्वायर के पास कौन से रेस्तरां हैं?"

नेविगेशन और यात्रा

• "LAX से हॉलीवुड तक वर्तमान यातायात के साथ ड्राइविंग निर्देश प्राप्त करें"
• "सेंट्रल पार्क से टाइम्स स्क्वायर तक पैदल चलने में कितना समय लगेगा?"
• "मेरे होटल (फोर सीज़न्स) से JFK हवाई अड्डे तक भीड़ के समय टैक्सी से यात्रा समय की गणना करें"

विज़ुअलाइज़ेशन और मानचित्र

• "Mapbox मैप रेंडर टूल का उपयोग करके, सैन फ्रांसिस्को में गोल्डन गेट ब्रिज से यूनियन स्क्वायर तक दिशा-निर्देश दिखाएं" — वास्तविक Mapbox मानचित्र पर एक लाइव, इंटरैक्टिव मार्ग रेंडर करता है
• "गोल्डन गेट ब्रिज से फिशरमैन्स व्हार्फ तक के मार्ग को दोनों स्थानों पर मार्कर के साथ दिखाने वाली मानचित्र छवि बनाएं"
• "मुख्य स्थलों को चिह्नित करके मैनहट्टन का उपग्रह दृश्य दिखाएं"
• "डाउनटाउन सिएटल के एक मील के भीतर सभी Starbucks स्थानों को उजागर करने वाला मानचित्र बनाएं"
• "इन निर्देशांकों पर एक फिल पॉलीगन दिखाएं: [...], [...] पर 'वेयरहाउस' लेबल वाले मार्कर के साथ" — render_map_tool के माध्यम से सीधे अपना स्वयं का GeoJSON रेंडर करता है, किसी अन्य Mapbox टूल की आवश्यकता नहीं है

विश्लेषण और योजना

• "डाउनटाउन पोर्टलैंड से कार द्वारा 30 मिनट के भीतर पहुँच योग्य क्षेत्र दिखाएं"
• "डेनवर में इन 3 होटल स्थानों (मैरियट, शेरेटन और हिल्टन) और कन्वेंशन सेंटर के बीच यात्रा समय मैट्रिक्स की गणना करें"
• "सैन फ्रांसिस्को में इन 3 पर्यटक आकर्षणों (गोल्डन गेट, म्यूज़िकल स्टेयर्स और फिशरमैन्स व्हार्फ) का दौरा करने के लिए इष्टतम मार्ग खोजें"
• "इन 8 पतों के लिए डिलीवरी मार्ग अनुकूलित करें: [पतों की सूची]"

GPS और मार्ग मिलान

• "इस GPS ट्रेस को साफ करें और सड़कों पर वास्तविक मार्ग दिखाएं: [टाइमस्टैम्प के साथ निर्देशांक की सूची]"
• "इस रिकॉर्ड की गई साइकिल यात्रा को साइकिलिंग नेटवर्क पर स्नैप करें: [GPS निर्देशांक]"
• "इस ड्राइविंग मार्ग को सड़क नेटवर्क से मिलाएं और यातायात भीड़ स्तर दिखाएं"

ऑफ़लाइन भू-स्थानिक गणना

• "इन दो निर्देशांकों के बीच मीलों में दूरी क्या है?"
• "इस बहुभुज के क्षेत्रफल की गणना वर्ग किलोमीटर में करें"
• "क्या 37.7749°N, 122.4194°W पर बिंदु इस सेवा क्षेत्र बहुभुज के अंदर है?"
• "सैन फ्रांसिस्को से न्यूयॉर्क तक बियरिंग क्या है?"
• "लंदन और पेरिस के बीच मध्यबिंदु खोजें"
• "इस स्थान के चारों ओर 5-मील बफर ज़ोन बनाएं"
• "इस पड़ोस की सीमा के सेंट्रोइड की गणना करें"
• "इन मार्ग निर्देशांकों के लिए बाउंडिंग बॉक्स क्या है?"
• "बिंदुओं की संख्या कम करने के लिए इस जटिल बहुभुज को सरल बनाएं"

बेहतर परिणामों के लिए सुझाव

• स्थानों के बारे में विशिष्ट रहें (पूर्ण पते या लैंडमार्क नामों का उपयोग करें)
• अपना पसंदीदा यात्रा तरीका निर्दिष्ट करें (ड्राइविंग, पैदल चलना, साइकिल चलाना)
• प्रासंगिक होने पर समय बाधाएं शामिल करें ("भीड़ के समय", "दोपहर 3 बजे")
• आवश्यकता होने पर विशिष्ट आउटपुट प्रारूप मांगें ("मानचित्र छवि के रूप में", "JSON प्रारूप में")

विस्तृत उदाहरण: विभिन्न उपयोग मामलों और MCP Inspector परीक्षण निर्देशों के साथ search-along-route प्रॉम्प्ट के व्यापक उदाहरणों के लिए examples/search-along-route.md देखें।

संसाधन

MCP सर्वर स्थिर संदर्भ डेटा को MCP संसाधनों के रूप में उजागर करता है। संसाधन डेटा तक केवल-पढ़ने की पहुँच प्रदान करते हैं जिसे क्लाइंट टूल कॉल किए बिना सीधे संदर्भित कर सकते हैं।

उपलब्ध संसाधन

Mapbox श्रेणियाँ संसाधन

URI पैटर्न: mapbox://categories या mapbox://categories/{language}

श्रेणी खोज टूल के साथ उपयोग के लिए उपलब्ध श्रेणी आईडी की पूरी सूची तक पहुँचें। श्रेणियों का उपयोग खोज परिणामों को प्रकार से फ़िल्टर करने के लिए किया जा सकता है (जैसे, "restaurant", "hotel", "gas_station")।

उदाहरण:

• mapbox://categories - डिफ़ॉल्ट (अंग्रेज़ी) श्रेणी सूची
• mapbox://categories/ja - जापानी श्रेणी नाम
• mapbox://categories/es - स्पेनिश श्रेणी नाम

संसाधनों तक पहुँच:

• मूल MCP संसाधन समर्थन वाले क्लाइंट: resources/read MCP प्रोटोकॉल विधि का उपयोग करें
• संसाधन समर्थन के बिना क्लाइंट: संसाधन URI के साथ resource_reader_tool का उपयोग करें

समृद्ध मानचित्र पूर्वावलोकन (render_map_tool)

इस सर्वर का हर भू-स्थानिक टूल (दिशा-निर्देश, आइसोक्रोन, खोज, और अधिक) अपना परिणाम render_map_tool के माध्यम से लाइव, इंटरैक्टिव Mapbox GL JS मानचित्र के रूप में प्रदर्शित कर सकता है — सर्वर का एकल विज़ुअलाइज़ेशन प्रिमिटिव। यह MCP Apps प्रोटोकॉल (@modelcontextprotocol/ext-apps) के माध्यम से चैट के भीतर सीधे एक स्व-निहित HTML पैनल के रूप में रेंडर करता है, समर्थित क्लाइंट में फुलस्क्रीन टॉगल के साथ:

• Claude Desktop ✅
• VS Code with GitHub Copilot ✅
• Claude Code ✅
• Goose ✅

इसका उपयोग करने के लिए आपको इस सर्वर के किसी अन्य टूल की आवश्यकता नहीं है। render_map_tool सीधे हाथ से बनाए गए GeoJSON को भी स्वीकार करता है — आपके अपने पॉलीगन, मार्कर और मार्ग — बिना directions_tool, isochrone_tool, या किसी अन्य Mapbox API कॉल पर निर्भरता के। पेलोड स्कीमा और एक पूर्ण स्टैंडअलोन उदाहरण के लिए पूर्ण render_map_tool गाइड देखें।

यदि आपको MCP Apps समर्थन के बिना क्लाइंट में गारंटीकृत स्थिर छवि की आवश्यकता है, तो इसके बजाय static_map_image_tool का उपयोग करें — यह एक base64-एन्कोडेड PNG/JPEG लौटाता है जिसे हर क्लाइंट प्रदर्शित कर सकता है।

CLIENT_NEEDS_RESOURCE_FALLBACK

संसाधन फॉलबैक टूल (गैर-अनुपालक क्लाइंट के लिए ऑप्ट-इन)

संसाधन एक मुख्य MCP सुविधा है जो अधिकांश क्लाइंट (Claude Desktop, VS Code, MCP Inspector, आदि) द्वारा समर्थित है। हालाँकि, कुछ क्लाइंट (जैसे smolagents) संसाधनों का बिल्कुल समर्थन नहीं करते हैं। इन क्लाइंट के लिए, सर्वर "संसाधन फॉलबैक टूल" प्रदान कर सकता है जो संसाधनों के समान सामग्री टूल कॉल के माध्यम से वितरित करते हैं।

फॉलबैक टूल:

• resource_reader_tool - URI द्वारा किसी भी संसाधन को पढ़ने के लिए सामान्य फॉलबैक
• category_list_tool - श्रेणी सूची तक पहुँच प्रदान करता है (mapbox://categories)

डिफ़ॉल्ट रूप से, ये टूल शामिल नहीं हैं (मानता है कि आपका क्लाइंट संसाधनों का समर्थन करता है)। यदि आपका क्लाइंट संसाधनों का समर्थन नहीं करता है, तो फॉलबैक टूल सक्षम करें:

export CLIENT_NEEDS_RESOURCE_FALLBACK=true

इसे कब सेट करें:

• ✅ smolagents या संसाधन समर्थन के बिना अन्य क्लाइंट का उपयोग करते समय true पर सेट करें
• ❌ Claude Desktop, VS Code, MCP Inspector, या किसी भी संसाधन-सक्षम क्लाइंट का उपयोग करते समय अनसेट (डिफ़ॉल्ट) छोड़ें
• ❌ अनिश्चित होने पर अनसेट छोड़ें (अधिकांश क्लाइंट संसाधनों का समर्थन करते हैं)

टूल

उपयोगिता टूल

संसाधन रीडर टूल

उन क्लाइंट के लिए MCP संसाधनों तक पहुँच प्रदान करता है जो मूल MCP संसाधन API का समर्थन नहीं करते हैं। श्रेणी सूची जैसे संसाधनों को पढ़ने के लिए इस टूल का उपयोग करें।

पैरामीटर:

• uri: पढ़ने के लिए संसाधन URI (जैसे, mapbox://categories, mapbox://categories/ja)

उपयोग उदाहरण:

• डिफ़ॉल्ट श्रेणियाँ पढ़ें: {"uri": "mapbox://categories"}
• जापानी श्रेणियाँ पढ़ें: {"uri": "mapbox://categories/ja"}

नोट: यदि आपका MCP क्लाइंट मूल संसाधनों का समर्थन करता है, तो बेहतर प्रदर्शन के लिए सीधे संसाधन API का उपयोग करना पसंद करें।

ऑफ़लाइन भू-स्थानिक टूल

ये टूल बिना Mapbox API कॉल की आवश्यकता के पूरी तरह से ऑफ़लाइन भू-स्थानिक गणना करते हैं। वे सटीक भौगोलिक गणनाओं के लिए Turf.js का उपयोग करते हैं और इंटरनेट कनेक्टिविटी के बिना भी कहीं भी काम करते हैं।

दूरी टूल

हैवरसाइन सूत्र का उपयोग करके दो भौगोलिक निर्देशांकों के बीच की दूरी की गणना करें।

विशेषताएँ:

• कई इकाइयों का समर्थन करता है: किलोमीटर, मील, मीटर, फीट, समुद्री मील
• सटीक ग्रेट-सर्कल दूरी गणना
• कोई API कॉल आवश्यक नहीं

उपयोग उदाहरण: "सैन फ्रांसिस्को (37.7749°N, 122.4194°W) और न्यूयॉर्क (40.7128°N, 74.0060°W) के बीच की दूरी क्या है?"

बहुभुज के भीतर बिंदु टूल

एक बहुभुज या मल्टीपॉलीगन के विरुद्ध एक या अधिक बिंदुओं का परीक्षण करें, केवल अंदर वाले लौटाएं। एक कॉल में एकल बिंदु या बैच को संभालता है।

विशेषताएँ:

• छेद वाले जटिल बहुभुजों के साथ काम करता है
• मल्टीपॉलीगॉन का समर्थन करता है
• एक कॉल में कितने भी बिंदुओं का बैच-परीक्षण करता है
• जियोफेंसिंग, डिलीवरी ज़ोन सत्यापन और ग्राहक विभाजन के लिए उपयोगी

उदाहरण उपयोग: "हमारे सेवा क्षेत्र के अंदर इनमें से कौन से डिलीवरी पते हैं?"

गंतव्य टूल

प्रारंभिक बिंदु, दिशा (bearing) और दूरी दिए जाने पर जियोडेसिक (ग्रेट-सर्कल) ऑफसेट का उपयोग करके एक गंतव्य बिंदु की गणना करें।

विशेषताएँ:

• सीधी-रेखा ऑफसेट, रूटेड पथ नहीं
• "X के 5 किमी उत्तर में एक बिंदु खोजें" या खोज ऑफसेट बनाने के लिए उपयोगी
• कोई API कॉल आवश्यक नहीं

उदाहरण उपयोग: "स्पेस नीडल के 10 किमी उत्तर-पूर्व में बिंदु क्या है?"

दिशा (Bearing) टूल

एक निर्देशांक से दूसरे निर्देशांक तक कम्पास दिशा (bearing) की गणना करें।

विशेषताएँ:

• डिग्री (0-360°) में bearing लौटाता है
• कार्डिनल दिशा प्रदान करता है (N, NE, E, SE, S, SW, W, NW)
• नेविगेशन और दिशात्मक प्रश्नों के लिए उपयोगी

उदाहरण उपयोग: "यहाँ से हवाई अड्डे तक जाने के लिए मुझे किस दिशा में जाना चाहिए?"

मध्यबिंदु टूल

ग्रेट सर्कल पथ के साथ दो निर्देशांकों के बीच भौगोलिक मध्यबिंदु खोजें।

विशेषताएँ:

• पृथ्वी की घुमावदार सतह पर सही मध्यबिंदु की गणना करता है
• मीटिंग बिंदु सुझावों के लिए उपयोगी
• लंबी दूरी की गणनाओं को सही ढंग से संभालता है

उदाहरण उपयोग: "सैन फ्रांसिस्को और न्यूयॉर्क के बीच आधा रास्ता क्या है?"

केन्द्रक टूल

किसी बहुभुज या मल्टीपॉलीगॉन के ज्यामितीय केंद्र (केन्द्रक) की गणना करें।

विशेषताएँ:

• जटिल आकृतियों के साथ काम करता है
• सभी बिंदुओं का अंकगणितीय माध्य लौटाता है
• लेबल या मार्कर लगाने के लिए उपयोगी

उदाहरण उपयोग: "इस पड़ोस की सीमा के लिए मुझे मार्कर कहाँ रखना चाहिए?"

क्षेत्रफल टूल

किसी बहुभुज के क्षेत्रफल की गणना करें।

विशेषताएँ:

• कई इकाइयों का समर्थन करता है: वर्ग मीटर, वर्ग किलोमीटर, एकड़, हेक्टेयर, वर्ग मील, वर्ग फुट
• पृथ्वी की सतह पर सटीक क्षेत्रफल गणना
• किसी भी आकार के बहुभुजों के साथ काम करता है

उदाहरण उपयोग: "इस पार्क का क्षेत्रफल एकड़ में क्या है?"

बाउंडिंग बॉक्स टूल

किसी ज्यामिति को समाहित करने वाले न्यूनतम बाउंडिंग बॉक्स (bbox) की गणना करें।

विशेषताएँ:

• बिंदुओं, रेखाओं, बहुभुजों और मल्टीपॉलीगॉन के साथ काम करता है
• [minLongitude, minLatitude, maxLongitude, maxLatitude] लौटाता है
• व्यूपोर्ट गणना और स्थानिक अनुक्रमण के लिए उपयोगी

उदाहरण उपयोग: "इस मार्ग के लिए बाउंडिंग बॉक्स क्या है?"

बफर टूल

किसी बिंदु, रेखा या बहुभुज के चारों ओर एक बफर ज़ोन (बहुभुज) बनाएं।

विशेषताएँ:

• कई दूरी इकाइयों का समर्थन करता है
• बिंदुओं के चारों ओर वृत्ताकार बफर बनाता है
• निकटता विश्लेषण और प्रभाव क्षेत्र बनाने के लिए उपयोगी

उदाहरण उपयोग: "मुझे इस स्थान के चारों ओर 5 किमी का बफर ज़ोन दिखाएं"

सरलीकरण टूल

डगलस-प्यूकर एल्गोरिथम का उपयोग करके किसी रेखा या बहुभुज में शीर्षों की संख्या कम करें।

विशेषताएँ:

• विवरण स्तर के लिए कॉन्फ़िगर करने योग्य सहनशीलता
• जटिलता कम करते हुए समग्र आकार बनाए रखता है
• फ़ाइल आकार कम करने और रेंडरिंग प्रदर्शन में सुधार के लिए उपयोगी
• टोपोलॉजी बनाए रखने का विकल्प (स्व-प्रतिच्छेदन रोकें)

उदाहरण उपयोग: "बिंदुओं की संख्या कम करने के लिए इस जटिल सीमा को सरल बनाएं"

लंबाई टूल

निर्देशांकों की एक श्रृंखला द्वारा परिभाषित रेखा की कुल लंबाई मापें।

विशेषताएँ:

• किलोमीटर, मील, मीटर और फुट का समर्थन करता है
• रूटिंग API कॉल के बिना खींचे गए मार्ग, पथ या सीमा को मापने के लिए उपयोगी

उदाहरण उपयोग: "यह हाइकिंग ट्रेल कितना लंबा है?"

उत्तल (Convex) टूल

बिंदुओं के एक समूह का उत्तल पतवार (convex hull) — उन सभी को समाहित करने वाला सबसे छोटा उत्तल बहुभुज — की गणना करें।

विशेषताएँ:

• बाउंडिंग-क्षेत्र विश्लेषण या कवरेज क्षेत्र का अनुमान लगाने के लिए उपयोगी
• API कॉल के बिना ऑफ़लाइन काम करता है

उदाहरण उपयोग: "सबसे छोटा बहुभुज क्या है जिसमें ये सभी स्टोर स्थान शामिल हैं?"

निकटतम बिंदु टूल

किसी दिए गए लक्ष्य बिंदु के लिए संग्रह में निकटतम बिंदु खोजें।

विशेषताएँ:

• प्रत्येक उम्मीदवार के लिए distance_tool कॉल करने और सॉर्ट करने से अधिक कुशल
• किसी स्थान के निकटतम स्टोर, स्टॉप या लैंडमार्क खोजने के लिए उपयोगी

उदाहरण उपयोग: "इनमें से कौन सा स्टोर मेरे वर्तमान स्थान के सबसे निकट है?"

रेखा पर निकटतम बिंदु टूल

किसी बिंदु को रेखा या मार्ग पर निकटतम स्थिति में स्नैप करें, उस बिंदु और उसकी दूरी को लौटाएं।

विशेषताएँ:

• "इस मार्ग पर कौन सा बिंदु मेरे स्थान के सबसे निकट है?" या API कॉल के बिना मैप-मैचिंग के लिए उपयोगी

उदाहरण उपयोग: "इस हाइकिंग ट्रेल पर मैं अभी किसके सबसे निकट हूँ?"

यूनियन, इंटरसेक्ट और डिफरेंस टूल

दो या अधिक बहुभुजों को संयोजित या तुलना करें — union_tool उन्हें एक ज्यामिति में मर्ज करता है, intersect_tool उनके साझा क्षेत्र को ढूंढता है, और difference_tool एक को दूसरे से घटाता है।

विशेषताएँ:

• सेवा क्षेत्रों को संयोजित करने, कवरेज ओवरलैप खोजने, या बहिष्करण क्षेत्रों की गणना करने के लिए उपयोगी (जैसे "ज़ोन A द्वारा कवर किया गया लेकिन ज़ोन B द्वारा नहीं?")
• पूरी तरह से ऑफ़लाइन काम करता है — कोई API कॉल आवश्यक नहीं
• प्रत्येक एक render_map_tool संदर्भ लौटाता है ताकि परिणाम को सीधे विज़ुअलाइज़ किया जा सके

उदाहरण उपयोग: "इन दो डिलीवरी ज़ोन को एक कवरेज क्षेत्र में संयोजित करें" / "ये दो आइसोक्रोन कहाँ ओवरलैप होते हैं?" / "इस सेवा क्षेत्र का कौन सा हिस्सा हमारे 15-मिनट के आइसोक्रोन द्वारा कवर नहीं है?"

Mapbox API टूल

श्रेणी सूची टूल (अप्रचलित)

⚠️ अप्रचलित: इसके बजाय URI mapbox://categories के साथ resource_reader_tool का उपयोग करें, या यदि आपका क्लाइंट MCP संसाधनों का समर्थन करता है तो mapbox://categories संसाधन तक सीधे पहुंचें।

यह टूल उन क्लाइंट्स के साथ पिछड़ी संगतता के लिए बनाए रखा गया है जो MCP संसाधनों या resource_reader_tool का समर्थन नहीं करते हैं।

मैट्रिक्स टूल

Mapbox Matrix API का उपयोग करके कई बिंदुओं के बीच यात्रा समय और दूरी की गणना करता है। विशेषताएँ शामिल हैं:

• कुशल एक-से-अनेक, अनेक-से-एक या अनेक-से-अनेक रूटिंग गणनाएँ
• विभिन्न यात्रा प्रोफाइलों के लिए समर्थन (driving-traffic, driving, walking, cycling)
• ट्रैफ़िक-जागरूक गणनाओं के लिए प्रस्थान समय विनिर्देश
• दूरी और अवधि मेट्रिक्स के साथ मार्ग सारांश
• दृष्टिकोण नियंत्रण (कर्ब/अप्रतिबंधित) और अनुमत प्रस्थान दिशाओं की सीमा

स्थिर छवि टूल

Mapbox static image API का उपयोग करके स्थिर मानचित्र छवियाँ उत्पन्न करता है। विशेषताएँ शामिल हैं:

• कस्टम मानचित्र शैलियाँ (streets, outdoors, satellite, आदि)
• समायोज्य छवि आयाम और ज़ूम स्तर
• कस्टम रंगों और लेबलों के साथ कई मार्करों के लिए समर्थन
• पॉलीलाइन और बहुभुज सहित ओवरले विकल्प
• निर्दिष्ट निर्देशांकों के लिए ऑटो-फिटिंग

श्रेणी खोज टूल

Mapbox Search Box category search API का उपयोग करके श्रेणी खोज करता है। विशेषताएँ शामिल हैं:

• श्रेणी के अनुसार रुचि के बिंदुओं की खोज (रेस्तरां, होटल, गैस स्टेशन, आदि)
• भौगोलिक निकटता द्वारा फ़िल्टरिंग
• अनुकूलन योग्य परिणाम सीमाएँ
• प्रत्येक परिणाम के लिए समृद्ध मेटाडेटा
• कई भाषाओं के लिए समर्थन

रिवर्स जियोकोडिंग टूल

Mapbox geocoding V6 API का उपयोग करके रिवर्स जियोकोडिंग करता है। विशेषताएँ शामिल हैं:

• भौगोलिक निर्देशांकों को मानव-पठनीय पतों में बदलें
• विवरण के अनुकूलन योग्य स्तर (सड़क, पड़ोस, शहर, आदि)
• प्रकार द्वारा परिणाम फ़िल्टरिंग (address, poi, neighborhood, आदि)
• कई भाषाओं के लिए समर्थन
• समृद्ध स्थान संदर्भ जानकारी

ग्राउंड स्थान टूल

"इस निर्देशांक के पास क्या है" प्रश्नों का एक ही कॉल में उत्तर देता है — स्थान का नाम, आस-पास के रुचि के बिंदु, और यात्रा-समय पहुंच — उद्धरणों के साथ लाइव Mapbox डेटा से प्राप्त। वेब खोज के साथ reverse_geocode_tool को श्रृंखलाबद्ध करने के बजाय इसका उपयोग करें।

विशेषताएँ:

• क्वेरी को वर्गीकृत करता है (रूटिंग, पड़ोस संदर्भ, POI खोज, या क्षेत्र/पहुंच) और केवल प्रासंगिक डेटा लाता है
• अनुरोध किए जाने पर श्रेणी द्वारा निकटवर्ती POI खोज
• यात्रा-समय पहुंच सारांश (आइसोक्रोन-आधारित)
• ग्राउंडेड स्थान और निकटवर्ती POI के साथ एक render_map_tool संदर्भ लौटाता है

उदाहरण उपयोग: "यह निर्देशांक किस पड़ोस में है, और क्या आस-पास कोई कॉफी शॉप है?"

स्थान विवरण टूल

किसी विशिष्ट स्थान के बारे में उसके Mapbox ID का उपयोग करके विस्तृत जानकारी प्राप्त करता है — फ़ोटो, खुलने का समय, रेटिंग, फ़ोन नंबर और वेबसाइट URL। किसी विशिष्ट परिणाम पर अधिक विवरण प्राप्त करने के लिए search_and_geocode_tool, category_search_tool, या reverse_geocode_tool के बाद उपयोग करें।

उदाहरण उपयोग: "मुझे उस पहले कॉफी शॉप परिणाम के बारे में और बताएं — समय, फ़ोन नंबर और वेबसाइट"

दिशा-निर्देश टूल

Mapbox Directions API का उपयोग करके रूटिंग दिशा-निर्देश प्राप्त करता है। विशेषताएँ शामिल हैं:

• विभिन्न रूटिंग प्रोफाइलों के लिए समर्थन: driving (लाइव ट्रैफ़िक या विशिष्ट के साथ), walking, और cycling
• कई वेपॉइंट्स से मार्ग (2-25 निर्देशांक जोड़े)
• वैकल्पिक मार्ग विकल्प
• मार्ग एनोटेशन (दूरी, अवधि, गति, भीड़)
• शेड्यूलिंग विकल्प:
  • driving और driving-traffic प्रोफाइल के लिए भविष्य का प्रस्थान समय (depart_at)
  • केवल driving प्रोफाइल के लिए वांछित आगमन समय (arrive_by)
• प्रोफ़ाइल-विशिष्ट अनुकूलन:
  • Driving: वाहन आयाम बाधाएँ (ऊँचाई, चौड़ाई, वजन)
• रूटिंग के लिए बहिष्करण विकल्प:
  • सामान्य बहिष्करण: फ़ेरी मार्ग, केवल-नकद टोल
  • Driving-विशिष्ट बहिष्करण: टोल, मोटरवे, बिना पक्की सड़कें, सुरंगें, देश की सीमाएँ, राज्य की सीमाएँ
  • कस्टम बिंदु बहिष्करण (बचने के लिए 50 भौगोलिक बिंदु तक)
• GeoJSON ज्यामिति आउटपुट प्रारूप

आइसोक्रोन टूल

Mapbox Isochrone API का उपयोग करके किसी स्थान से निर्दिष्ट समय के भीतर पहुंच योग्य क्षेत्रों की गणना करता है। विशेषताएँ शामिल हैं:

• विभिन्न यात्रा प्रोफाइलों के लिए समर्थन (driving, walking, cycling)
• अनुकूलन योग्य यात्रा समय या दूरी
• कई कंटूर निर्माण (जैसे, 15, 30, 45 मिनट की सीमाएँ)
• वैकल्पिक प्रस्थान या आगमन समय विनिर्देश
• विज़ुअलाइज़ेशन के लिए रंग अनुकूलन

खोज और जियोकोड टूल

उस API द्वारा समर्थित POI, पते, स्थानों और किसी भी अन्य प्रकार की खोज और जियोकोडिंग को शक्ति देने के लिए Mapbox Search Box Text Search API एंडपॉइंट का उपयोग करता है। यह टूल उस कार्यक्षमता को समेकित करता है जो पहले ForwardGeocodeTool और PoiSearchTool (इस MCP सर्वर के पुराने संस्करणों से) द्वारा प्रदान की गई थी, एक ही टूल में।

मैप मैचिंग टूल

Mapbox Map Matching API का उपयोग करके GPS ट्रेस को सड़क नेटवर्क पर स्नैप करता है। विशेषताएँ शामिल हैं:

• शोरगुल वाले GPS ट्रेस को सड़क नेटवर्क पर साफ मार्गों में बदलें
• विभिन्न यात्रा प्रोफाइलों के लिए समर्थन (driving, driving-traffic, walking, cycling)
• प्रति अनुरोध 100 निर्देशांक जोड़े तक संभालें
• गति के आधार पर बेहतर सटीकता के लिए वैकल्पिक टाइमस्टैम्प
• विभिन्न GPS गुणवत्ता स्तरों के लिए कॉन्फ़िगर करने योग्य स्नैप त्रिज्या
• मार्ग एनोटेशन (गति सीमाएँ, दूरी, अवधि, ट्रैफ़िक भीड़)
• कई ज्यामिति आउटपुट प्रारूप (GeoJSON, polyline)

उदाहरण उपयोग: "इस GPS ट्रेस को साफ करें और इसे सड़कों पर स्नैप करें: [टाइमस्टैम्प के साथ निर्देशांक]"

अनुकूलन टूल

Mapbox Optimization API का उपयोग करके कई स्थानों के माध्यम से इष्टतम मार्ग खोजता है। विशेषताएँ शामिल हैं:

• 2-12 स्थानों के लिए ट्रैवलिंग सेल्समैन समस्या (TSP) हल करें
• विभिन्न यात्रा प्रोफाइलों के लिए समर्थन (driving, driving-traffic, walking, cycling)
• लचीला प्रारंभ और अंत बिंदु कॉन्फ़िगरेशन
• राउंडट्रिप या एक-तरफ़ा यात्रा अनुकूलन
• टर्न-बाय-टर्न नेविगेशन निर्देश (वैकल्पिक)
• मार्ग एनोटेशन (दूरी, अवधि, गति)
• कई ज्यामिति आउटपुट प्रारूप (GeoJSON, polyline)

उदाहरण उपयोग: "इन 5 स्टॉप्स पर जाने के लिए इष्टतम मार्ग खोजें: [पतों या निर्देशांकों की सूची]"

नोट: उन्नत सुविधाओं (समय विंडो, क्षमता बाधाएँ, कई वाहन) वाला एक V2 API उपलब्ध है लेकिन बीटा एक्सेस की आवश्यकता है। V2 कार्यान्वयन कोडबेस में शामिल है लेकिन डिफ़ॉल्ट रूप से पंजीकृत नहीं है।

विकास

सर्वर का निरीक्षण

Node.js का उपयोग करना

# Run the built image
npm run inspect:build

Docker का उपयोग करना

# Build the Docker image
docker build -t mapbox-mcp-server .

# Run and inspect the server
npx @modelcontextprotocol/inspector docker run -i --rm --env MAPBOX_ACCESS_TOKEN="YOUR_TOKEN" mapbox-mcp-server

नया टूल बनाएं

npx plop create-tool
# provide tool name without suffix (e.g. Search)

नया संस्करण जारी करना

# 1. Bump version in package.json
npm version <new-version> --no-git-tag-version

# 2. Sync version to manifest.json and server.json
npm run sync-manifest

# 3. Prepare CHANGELOG (replaces "Unreleased" with version and date)
npm run changelog:prepare-release <new-version>

# 4. Update package-lock.json
npm install

# 5. Review changes, then commit and tag
git add package.json package-lock.json manifest.json server.json CHANGELOG.md
git commit -m "Release v<new-version>"
git tag v<new-version>
git push && git push --tags

महत्वपूर्ण: प्रकाशक वर्कफ़्लो सत्यापित करता है कि package.json और server.json संस्करण रिलीज़ संस्करण से मेल खाते हैं। संस्करण बंप या मैनिफेस्ट सिंक को छोड़ने से प्रकाशन विफलताएँ होंगी।

OpenTelemetry ट्रेसिंग

इस MCP सर्वर में उत्पादन अवलोकन के लिए व्यापक OpenTelemetry ट्रेसिंग शामिल है:

त्वरित डेमो

# 1. Copy the example configuration
cp .env.example .env

# 2. Edit .env to add your MAPBOX_ACCESS_TOKEN and configure tracing

# 3. Start Jaeger for local development
npm run tracing:jaeger:start

# 4. Run the server (it will automatically use .env configuration)
npm run inspect:build

# 5. View traces at http://localhost:16686

# 6. Stop Jaeger when done
npm run tracing:jaeger:stop

नोट: सर्वर स्टार्टअप पर आपकी .env फ़ाइल से कॉन्फ़िगरेशन स्वचालित रूप से लोड करता है। .env.example फ़ाइल में कई ऑब्ज़र्वेबिलिटी प्लेटफ़ॉर्म के लिए कॉन्फ़िगरेशन उदाहरण शामिल हैं।

समर्थित ऑब्ज़र्वेबिलिटी प्लेटफ़ॉर्म

.env.example में शामिल कॉन्फ़िगरेशन उदाहरण:

क्लाउड प्रदाता:

• ☁️ AWS X-Ray
• ☁️ Azure Monitor (Application Insights)
• ☁️ Google Cloud Trace

SaaS प्लेटफ़ॉर्म:

• 📊 Datadog
• 📊 New Relic
• 📊 Honeycomb
• 📊 कोई भी OTLP-संगत बैकएंड

प्रोडक्शन कॉन्फ़िगरेशन

पूर्ण सेटअप निर्देशों के लिए docs/tracing.md देखें, जिनमें शामिल हैं:

• 🔧 प्लेटफ़ॉर्म-विशिष्ट कॉन्फ़िगरेशन गाइड
• 📊 प्रमाणीकरण और एंडपॉइंट सेटअप
• 🎯 कस्टम ट्रेस विशेषताएँ और संदर्भ
• 🚀 प्रदर्शन अनुकूलन (न्यूनतम ओवरहेड)
• 🔍 समस्या निवारण और डिबगिंग

ट्रेसिंग सुविधाएँ:

• ✅ कॉन्फ़िगरेशन लोडिंग ट्रेसिंग (.env फ़ाइल लोडिंग)
• ✅ स्वचालित टूल निष्पादन ट्रेसिंग
• ✅ CloudFront सहसंबंध आईडी के साथ HTTP अनुरोध इंस्ट्रूमेंटेशन
• ✅ कॉन्फ़िगर करने योग्य एक्सपोर्टर (कंसोल, OTLP)
• ✅ सुरक्षा-जागरूक (डेटा सुरक्षा, JWT सत्यापन)
• ✅ प्रोडक्शन-तैयार (<1% CPU ओवरहेड)

योगदान

हम Mapbox MCP सर्वर में योगदान का स्वागत करते हैं! पुल रिक्वेस्ट सबमिट करने से पहले कृपया CONTRIBUTING.md पढ़ें।

पूर्ण मानक और दिशानिर्देश:

• CONTRIBUTING.md - आरंभ करना, PR प्रक्रिया, त्वरित संदर्भ
• इंजीनियरिंग मानक (docs/engineering_standards.md) - पूर्ण कोड गुणवत्ता, परीक्षण, दस्तावेज़ीकरण और सहयोग मानक
• Claude Code गाइड (CLAUDE.md) - Claude Code का उपयोग करने वाले योगदानकर्ताओं के लिए मानक और पैटर्न
• AI एजेंट निर्देश (AGENTS.md) - अन्य AI कोडिंग सहायकों (Cursor, Continue, Aider, आदि) के लिए गाइड
• GitHub Copilot दिशानिर्देश - GitHub Copilot का जिम्मेदारी से उपयोग करने के लिए सर्वोत्तम अभ्यास

योगदानकर्ताओं के लिए त्वरित आरंभ

1. रिपॉजिटरी को फोर्क करें और अपना फोर्क क्लोन करें
2. निर्भरताएँ स्थापित करें: npm install
3. हमारे कोडिंग मानकों का पालन करते हुए अपने बदलाव करें
4. परीक्षण और लिंटिंग चलाएँ: npm test && npm run lint
5. किसी भी नई कार्यक्षमता के लिए परीक्षण जोड़ें
6. स्पष्ट विवरण के साथ पुल रिक्वेस्ट सबमिट करें

सभी योगदानों को हमारी CI जाँच और कोड समीक्षा प्रक्रिया पास करनी होगी। विस्तृत आवश्यकताओं के लिए docs/engineering_standards.md देखें।

डेटा उपयोग और गोपनीयता

Mapbox APIs को कौन सा डेटा भेजा जाता है

जब आप MCP सर्वर टूल का उपयोग करते हैं, तो निम्नलिखित डेटा आपके वातावरण से सीधे Mapbox APIs को भेजा जाता है:

• जियोकोडिंग टूल: पता/स्थान टेक्स्ट, निर्देशांक, देश/क्षेत्र फ़िल्टर
• खोज टूल: खोज क्वेरी, निकटता के लिए स्थान निर्देशांक, श्रेणी फ़िल्टर
• दिशा-निर्देश टूल: प्रारंभ/अंत निर्देशांक, वेपॉइंट, रूटिंग प्राथमिकताएँ, वाहन बाधाएँ
• मैट्रिक्स टूल: कई समन्वय जोड़े, यात्रा प्रोफ़ाइल, प्रस्थान समय
• स्थिर मानचित्र टूल: निर्देशांक, ज़ूम स्तर, स्टाइलिंग प्राथमिकताएँ, मार्कर जानकारी
• आइसोक्रोन टूल: मूल निर्देशांक, समय/दूरी पैरामीटर, यात्रा प्रोफ़ाइल

आपकी गोपनीयता

• स्थानीय निष्पादन: सभी API कॉल आपके वातावरण से सीधे Mapbox APIs को किए जाते हैं
• टोकन सुरक्षा: आपका Mapbox API टोकन आपकी स्थानीय मशीन पर रहता है और इस MCP सर्वर को कभी प्रेषित या संग्रहीत नहीं किया जाता है
• कोई डेटा संग्रहण नहीं: यह MCP सर्वर आपके किसी भी डेटा या API अनुरोध को संग्रहीत, लॉग या एकत्र नहीं करता है
• सीधा संचार: आपके और Mapbox APIs के बीच कोई मध्यस्थ सर्वर नहीं है

तृतीय-पक्ष डेटा उपयोग

• Mapbox की गोपनीयता नीति उनके APIs को भेजे गए डेटा को नियंत्रित करती है: https://www.mapbox.com/legal/privacy/
• API उपयोग: इन टूल के माध्यम से किए गए सभी अनुरोधों पर मानक Mapbox API शर्तें लागू होती हैं
• डेटा प्रतिधारण: डेटा प्रतिधारण नीतियों के लिए Mapbox के दस्तावेज़ीकरण देखें

सहायता और संपर्क

MCP सर्वर मुद्दों के लिए

• ईमेल: mcp-feedback@mapbox.com
• GitHub Issues: बग और फीचर अनुरोध रिपोर्ट करें

Mapbox API प्रश्नों के लिए

• Mapbox सहायता: https://support.mapbox.com/
• दस्तावेज़ीकरण: https://docs.mapbox.com/
• API स्थिति: https://status.mapbox.com/

रखरखाव प्रतिबद्धता

यह MCP सर्वर आधिकारिक रूप से Mapbox, Inc. द्वारा बनाए रखा जाता है। हम प्रदान करते हैं:

• नई Mapbox API सुविधाओं के लिए नियमित अपडेट
• बग फिक्स और सुरक्षा अपडेट
• नवीनतम MCP प्रोटोकॉल संस्करणों के साथ संगतता
• GitHub मुद्दों के माध्यम से सामुदायिक सहायता

---

MIT लाइसेंस