Mapbox MCP Server

आधिकारिक

Unlock geospatial intelligence through Mapbox APIs like geocoding, POI search, directions, isochrones and more.

GitHub
347

दस्तावेज़

Mapbox MCP सर्वर

npm version

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

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

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

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

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

Mapbox MCP Server Demo

उपयोग

इस 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 उपकरणों का उपयोग करें

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

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

स्थान खोज

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

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

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

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

  • "गोल्डन गेट ब्रिज से फिशरमैन वार्फ तक के मार्ग को दोनों स्थानों पर मार्कर के साथ दिखाने वाली एक मानचित्र छवि बनाएँ"
  • "मुझे प्रमुख स्थलों के साथ मैनहट्टन का एक उपग्रह दृश्य दिखाओ"
  • "डाउनटाउन सिएटल के एक मील के भीतर सभी स्टारबक्स स्थानों को हाइलाइट करने वाला एक मानचित्र तैयार करें"

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

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

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

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

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

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

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

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

विस्तृत उदाहरण: विभिन्न उपयोग मामलों और MCP इंस्पेक्टर परीक्षण निर्देशों के साथ मार्ग-के-साथ-खोज प्रॉम्प्ट के व्यापक उदाहरणों के लिए 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 का उपयोग करें

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

static_map_image_tool सभी क्लाइंट को प्राप्त होने वाली base64 छवि के अतिरिक्त, संगत क्लाइंट में एक इंटरैक्टिव मानचित्र पूर्वावलोकन पैनल प्रदान करता है।

यह सर्वर MCP ऐप्स प्रोटोकॉल (@modelcontextprotocol/ext-apps) लागू करता है, जो चैट के अंदर सीधे एक स्व-निहित HTML ऐप पैनल प्रस्तुत करता है। समर्थित क्लाइंट फ़ुलस्क्रीन टॉगल के साथ एक इंटरैक्टिव मानचित्र दिखाते हैं:

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

सभी क्लाइंट प्रोटोकॉल समर्थन की परवाह किए बिना base64-एन्कोडेड मानचित्र छवि प्राप्त करते हैं — इंटरैक्टिव पूर्वावलोकन मानक छवि प्रतिक्रिया के शीर्ष पर एक प्रगतिशील वृद्धि है।

लीगेसी: MCP-UI

यह सर्वर MCP-UI (@mcp-ui/server) के लिए भी समर्थन बनाए रखता है, जो एम्बेडेड iframe पूर्वावलोकन के लिए एक पुराना खुला विनिर्देश है। MCP ऐप्स अनुशंसित प्रोटोकॉल है; MCP-UI समर्थन पश्चगामी संगतता के लिए रखा गया है।

MCP-UI डिफ़ॉल्ट रूप से सक्षम है। इसे अक्षम करने के लिए, कमांड-लाइन फ़्लैग के रूप में --disable-mcp-ui पास करें या ENABLE_MCP_UI=false सेट करें। विवरण के लिए MCP-UI दस्तावेज़ीकरण देखें।

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

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

  • ✅ true पर सेट करें यदि smolagents या संसाधन समर्थन के बिना अन्य क्लाइंट का उपयोग कर रहे हैं
  • ❌ यदि 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) के बीच की दूरी क्या है?"

बहुभुज में बिंदु उपकरण

परीक्षण करें कि क्या कोई बिंदु किसी बहुभुज या बहु-बहुभुज के अंदर है।

विशेषताएँ:

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

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

दिशा उपकरण

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

विशेषताएँ:

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

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

मध्यबिंदु उपकरण

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

विशेषताएँ:

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

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

केंद्रक उपकरण

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

विशेषताएँ:

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

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

क्षेत्र उपकरण

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

विशेषताएँ:

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

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

बाउंडिंग बॉक्स उपकरण

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

विशेषताएँ:

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

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

बफर टूल

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

विशेषताएँ:

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

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

सरलीकरण टूल

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

विशेषताएँ:

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

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

Mapbox API टूल

श्रेणी सूची टूल (पदावनत)

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

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

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

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

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

स्थैतिक छवि टूल

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

मानचित्र मिलान टूल

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

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

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

अनुकूलन टूल

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

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

उदाहरण उपयोग: "इन 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 पढ़ें।

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

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

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

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

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

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

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

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

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

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

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

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

समर्थन और संपर्क

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

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

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

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

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

MIT लाइसेंस