Mapbox

Mapbox MCP Server

Mapbox APIs के लिए Model Context Protocol (MCP) लागू करने वाला Node.js सर्वर।

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

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

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

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

उपयोग

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

होस्ट किया गया MCP एंडपॉइंट

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

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

अलग-अलग क्लाइंट और API उपयोग के लिए विस्तृत सेटअप निर्देशों हेतु होस्ट किए गए MCP Server की मार्गदर्शिका देखें।

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 टूल के बिना, स्वतंत्र रूप से अपना डेटा रेंडर करने का तरीका
• उपयोगकर्ता से जानकारी लेना - 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 पर किसी को उतारने के लिए सबसे नज़दीकी मार्ग-योग्य बिंदु"

स्थान खोज

• "Empire State Building से पैदल दूरी के भीतर कॉफ़ी की दुकानें खोजें"
• "मैं Seattle से Portland जाना चाहता हूँ, क्या रास्ते में कोई Starbucks है?"
• "Boston से New York के मार्ग पर गैस स्टेशन दिखाएँ"
• "Times Square के पास कौन-से रेस्तराँ हैं?"

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

• "मौजूदा ट्रैफ़िक के साथ LAX से Hollywood तक ड्राइविंग के निर्देश दें"
• "Central Park से Times Square तक पैदल जाने में कितना समय लगेगा?"
• "रश आवर के दौरान टैक्सी से मेरे होटल (Four Seasons) से JFK Airport तक का यात्रा समय निकालें"

दृश्यांकन और मानचित्र

• "Mapbox मानचित्र रेंडर टूल का उपयोग करके, San Francisco में Golden Gate Bridge से Union Square तक के निर्देश दिखाएँ" — वास्तविक Mapbox मानचित्र पर लाइव, इंटरैक्टिव मार्ग रेंडर करता है
• "Golden Gate Bridge से Fisherman's Wharf तक का मार्ग दिखाने वाली मानचित्र छवि बनाएँ, जिसमें दोनों स्थानों पर मार्कर हों"
• "Manhattan का सैटेलाइट दृश्य दिखाएँ और प्रमुख दर्शनीय स्थलों को चिह्नित करें"
• "Seattle के डाउनटाउन से एक मील के भीतर मौजूद सभी Starbucks स्थानों को हाइलाइट करने वाला मानचित्र बनाएँ"
• "इन निर्देशांकों पर एक भरा हुआ बहुभुज दिखाएँ: [...], और [...] पर 'Warehouse' लेबल वाला मार्कर रखें" — किसी अन्य Mapbox टूल की आवश्यकता के बिना, अपना GeoJSON सीधे render_map_tool के ज़रिए रेंडर करता है

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

• "Portland के डाउनटाउन से कार द्वारा 30 मिनट के भीतर पहुँच योग्य क्षेत्र दिखाएँ"
• "Denver के कन्वेंशन सेंटर और इन 3 होटल स्थानों (Marriott, Sheraton और Hilton) के बीच यात्रा समय मैट्रिक्स निकालें"
• "San Francisco में इन 3 पर्यटक आकर्षणों (Golden Gate, Musical Stairs और Fisherman's Wharf) पर जाने का सर्वोत्तम मार्ग खोजें"
• "इन 8 पतों के लिए डिलीवरी मार्ग अनुकूलित करें: [पतों की सूची]"

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

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

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

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

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

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

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

संसाधन

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

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

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

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

श्रेणी खोज टूल के साथ उपयोग के लिए उपलब्ध श्रेणी ID की पूरी सूची देखें। खोज परिणामों को प्रकार के आधार पर फ़िल्टर करने के लिए श्रेणियों का उपयोग किया जा सकता है (उदाहरण के लिए, "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 ✅
• GitHub Copilot के साथ VS Code ✅
• 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 का उपयोग करते हैं और इंटरनेट कनेक्टिविटी के बिना भी कहीं भी काम करते हैं।

दूरी टूल

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

विशेषताएँ:

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

उपयोग का उदाहरण: "San Francisco (37.7749°N, 122.4194°W) और New York (40.7128°N, 74.0060°W) के बीच की दूरी कितनी है?"

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

बहुभुज या बहु-बहुभुज के भीतर एक या अधिक बिंदुओं की जाँच करें और केवल भीतर मौजूद बिंदु लौटाएँ। एक कॉल में एक बिंदु या कई बिंदुओं के बैच को संभालता है।

विशेषताएँ:

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

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

गंतव्य टूल

जियोडेसिक (महावृत्त) ऑफ़सेट का उपयोग करके, शुरुआती बिंदु, दिशा और दूरी के आधार पर गंतव्य बिंदु की गणना करें।

विशेषताएँ:

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

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

दिशा कोण टूल

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

विशेषताएँ:

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

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

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

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

विशेषताएँ:

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

उदाहरण उपयोग: "San Francisco और New York के बीच आधा रास्ता कहाँ है?"

केंद्रक टूल

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

विशेषताएँ:

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

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

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

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

विशेषताएँ:

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

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

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

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

विशेषताएँ:

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

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

बफ़र टूल

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

विशेषताएँ:

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

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

सरलीकरण टूल

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

विशेषताएँ:

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

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

लंबाई टूल

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

विशेषताएँ:

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

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

उत्तल टूल

बिंदुओं के समूह का उत्तल आवरण निकालें — वह सबसे छोटा उत्तल बहुभुज जिसमें वे सभी समाहित हों।

विशेषताएँ:

• बाउंडिंग-क्षेत्र विश्लेषण या कवरेज क्षेत्र का अनुमान लगाने के लिए उपयोगी
• 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) का समर्थन
• ट्रैफ़िक के अनुसार गणनाओं के लिए प्रस्थान समय निर्दिष्ट करने की सुविधा
• दूरी और अवधि के मेट्रिक्स के साथ मार्ग का सारांश
• पहुँचने का तरीका (curb/unrestricted) और अनुमत प्रस्थान दिशाओं की सीमा नियंत्रित करने की सुविधा

स्थिर छवि टूल

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

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

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

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

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

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

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

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

ज़मीनी स्थान टूल

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

विशेषताएँ:

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

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

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

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

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

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

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

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

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

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

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

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

Mapbox Search Box Text Search API एंडपॉइंट का उपयोग करके POI, पतों, स्थानों और उस 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 कार्यान्वयन कोडबेस में शामिल है, लेकिन डिफ़ॉल्ट रूप से पंजीकृत नहीं है।

फ़ीडबैक टूल

Mapbox Feedback API (Public Preview) के माध्यम से ऐप या एजेंट के बारे में उपयोगकर्ता का फ़ीडबैक उसके डेवलपर को भेजता है। फ़ीडबैक उस खाते के अंतर्गत दर्ज होता है जिसके पास एक्सेस टोकन है। इसलिए, जब आप इस सर्वर पर अपने टोकन से कोई ऐप या एजेंट बनाते हैं, तो आपके उपयोगकर्ताओं का फ़ीडबैक उसी फ़ीड में आता है जिसमें आपके ऐप के Feedback Agent की रिपोर्टें आती हैं, और आप उसकी समीक्षा Feedback Explorer में करते हैं। यह Mapbox को समस्याओं की रिपोर्ट नहीं करता। Feedback Agent की तरह, इसका उपयोग आपके उत्पाद के बारे में ऐसी किसी भी बात के लिए किया जा सकता है जिससे आपको यह समझने में मदद मिले कि उपयोगकर्ताओं को क्या चाहिए, उदाहरण के लिए:

• कोई ऐसी जगह जो बंद हो चुकी हो, जिसकी जानकारी गलत हो, या जो गलत जगह पर दिखाई गई हो
• कोई ऐसी जगह या पता जिसे ढूँढ़ा न जा सके
• कोई बंद सड़क, गलत गति सीमा, या गलत तरीके से दिखाया गया ट्रैफ़िक
• ऐसा मार्ग जिसमें अवैध मोड़ या प्रवेश हो, या कोई मार्ग ही न हो
• ऐप के बारे में कुछ, जैसे कोई बग या सुझाव (application_issue)

यह फ़ीडबैक का पाठ, एक श्रेणी और स्थान भेजता है, और आइटम का आईडी और स्थिति लौटाता है। स्थान वैकल्पिक है, उन फ़ीडबैक के लिए जो किसी जगह के बारे में नहीं हैं; API को स्थान देना ज़रूरी है, इसलिए फ़िलहाल Feedback API टीम की सलाह के अनुसार टूल 0, 0 भेजता है। उपयोगकर्ता की अनुमति के बिना कुछ भी नहीं भेजा जाता: elicitation का समर्थन करने वाले क्लाइंट पहले पुष्टि का संकेत दिखाते हैं, और बाकी सभी जगह टूल का विवरण मॉडल से चैट में पुष्टि करने को कहता है।

Public Preview के दौरान Feedback API मुफ़्त है। General Availability पर, Feedback Agent हर फ़ीडबैक आइटम के लिए $0.02 शुल्क लेता है। एक ही समस्या की दो बार रिपोर्ट दर्ज होने से बचाने के लिए, भेजने से पहले टूल पिछले 30 दिनों की खाते की अपनी रिपोर्ट जाँचता है। अगर 50 m के भीतर उसी श्रेणी की कोई रिपोर्ट अब भी समीक्षा की प्रतीक्षा कर रही हो (बिना स्थान वाले फ़ीडबैक की जाँच नहीं होती), तो यह नई रिपोर्ट भेजने के बजाय वही रिपोर्ट लौटाता है। Feedback API केवल खाते की अपनी रिपोर्ट दिखाता है, इसलिए यह दूसरे खातों की रिपोर्ट का पता नहीं लगा सकता। अगर उपयोगकर्ता कहता है कि उसकी समस्या अलग है, तो send_anyway: true यह जाँच छोड़ देता है।

आवश्यकताएँ: भेजने के लिए एक्सेस टोकन में user-feedback:write स्कोप होना चाहिए, और डुप्लिकेट जाँच के लिए user-feedback:read स्कोप। लिखने का स्कोप न होने पर टूल इस बारे में त्रुटि लौटाता है। पढ़ने का स्कोप न होने पर यह जाँच किए बिना भेजता है और परिणाम में इसकी जानकारी देता है। टूल को शामिल न करने के लिए, सर्वर को --disable-tools feedback_tool के साथ शुरू करें।

उपयोग का उदाहरण: "Blue Bottle on Mint St पिछले साल बंद हो गया था, क्या आप इसे फ़ीडबैक के रूप में भेज सकते हैं?"

Report टूल

Mapbox MCP सर्वर के बारे में फ़ीडबैक—जैसे कोई बग, गलत या भ्रमित करने वाला परिणाम देने वाला टूल, कोई अनुपलब्ध क्षमता या सुझाव—इसे बनाने वाली Mapbox टीम को भेजता है। यह आपकी नहीं, Mapbox के अपने खाते के अंतर्गत दर्ज होता है, इसलिए इसके लिए किसी अतिरिक्त टोकन स्कोप की ज़रूरत नहीं होती; और बाद में इसे पढ़ा या वापस नहीं लिया जा सकता। इसका उपयोग गलत मैप, जगह या रूटिंग डेटा की रिपोर्ट करने के लिए नहीं है।

सर्वर पाठ के अंत में अपना संस्करण, क्लाइंट का नाम और संस्करण, और उस टूल का नाम जोड़ता है जिसके बारे में फ़ीडबैक दिया जा रहा है। उपयोगकर्ता की अनुमति के बिना कुछ भी नहीं भेजा जाता: elicitation का समर्थन करने वाले क्लाइंट पहले पुष्टि का संकेत दिखाते हैं, और बाकी सभी जगह टूल का विवरण मॉडल से चैट में पुष्टि करने को कहता है।

यह Feedback API टीम द्वारा Mapbox CLI के mapbox report कमांड के लिए जोड़े गए एंडपॉइंट का उपयोग करता है। टूल को शामिल न करने के लिए, सर्वर को --disable-tools report_tool के साथ शुरू करें।

उपयोग का उदाहरण: "मैप ने मेरे किसी भी isochrone को नहीं बनाया। क्या आप Mapbox MCP टीम को बता सकते हैं?"

सार्वजनिक टोकन सूचीबद्ध करने वाला टूल

खाते के सार्वजनिक (pk.) एक्सेस टोकन सूचीबद्ध करता है। यह ऐसे एजेंट के लिए है जो चैट के बाहर कोई वेब पेज या ऐप बना रहा हो, जो Mapbox GL JS लोड करता हो या ब्राउज़र से Mapbox APIs को कॉल करता हो। चैट में, render_map_tool को किसी टोकन की ज़रूरत नहीं होती। हर टोकन के साथ उसका नाम, यह जानकारी कि वह डिफ़ॉल्ट है या नहीं, उसके URL प्रतिबंध और उसके स्कोप दिए जाते हैं।

site_url पास करें (जहाँ पेज चलेगा), और अगर खाते में उस URL तक सीमित कोई टोकन है, तो टूल उसकी सिफ़ारिश करता है। अन्यथा यह डिफ़ॉल्ट सार्वजनिक टोकन की सिफ़ारिश करता है और बताता है कि प्रकाशित साइट को इसके बजाय URL-प्रतिबंधित टोकन इस्तेमाल करना चाहिए, साथ ही ऐसा टोकन बनाने का लिंक देता है। बिना प्रतिबंध वाले सार्वजनिक टोकन की कॉपी पाने वाला कोई भी व्यक्ति उसका उपयोग कर सकता है, और उसका उपयोग शुल्क खाते पर लगेगा।

यह कभी भी गुप्त या अस्थायी टोकन नहीं लौटाता, और टोकन बना नहीं सकता (इसके लिए tokens:write चाहिए; DevKit server का create_token_tool यह काम करता है)।

आवश्यकताएँ: सूची बनाने के लिए tokens:read स्कोप चाहिए; यही स्कोप चैट में मौजूद मैप डिफ़ॉल्ट सार्वजनिक टोकन ढूँढ़ने के लिए पहले से इस्तेमाल करता है। pk. एक्सेस टोकन के साथ, या जब सर्वर के अपने MAPBOX_ACCESS_TOKEN पर सूची बनाने में विफलता हो और MAPBOX_PUBLIC_TOKEN सेट हो, तो यह वही टोकन लौटाता है। अपने bearer token वाला कॉलर (होस्ट किया गया सर्वर) कभी भी MAPBOX_PUBLIC_TOKEN प्राप्त नहीं करता, और अन्य URL तक सीमित टोकन की कभी सिफ़ारिश नहीं की जाती। टूल को शामिल न करने के लिए, सर्वर को --disable-tools list_public_tokens_tool के साथ शुरू करें।

उपयोग का उदाहरण: "मेरे लिए एक ऐसा single-page site बनाइए जो Mapbox मैप पर हमारे तीन स्टोर के स्थान दिखाए।"

विकास

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

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 अनुरोध इंस्ट्रूमेंटेशन
• ✅ कॉन्फ़िगर किए जा सकने वाले एक्सपोर्टर (console, OTLP)
• ✅ सुरक्षा का ध्यान रखने वाला (डेटा सुरक्षा, JWT सत्यापन)
• ✅ प्रोडक्शन के लिए तैयार (<1% CPU ओवरहेड)

योगदान

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

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

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

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

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

• स्थानीय निष्पादन: सभी 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 issues के माध्यम से समुदाय सहायता

---

MIT License