Mapbox MCP Server

resmi

Mapbox API'leri (jeokodlama, POI araması, yol tarifleri, izokronlar ve daha fazlası) aracılığıyla coğrafi zeka kullanımına erişin.

GitHub
347

Dokümantasyon

Mapbox MCP Sunucusu

npm version

Mapbox API'leri için Model Bağlam Protokolü (MCP) uygulayan Node.js sunucusu.

Yapay Zeka Uygulamalarınız için Konumsal Zekayı Açığa Çıkarın

Mapbox MCP Sunucusu, Mapbox'ın kapsamlı konum zekası platformuna sorunsuz erişim sağlayarak herhangi bir yapay zeka ajanını veya uygulamasını konumsal olarak farkında bir sisteme dönüştürür. Bu sunucu ile yapay zekanız yerleri anlayabilir ve hakkında akıl yürütebilir, fiziksel dünyada gezinebilir ve aşağıdakiler dahil zengin konumsal verilere erişebilir:

  • Adresleri ve yer adlarını koordinatlara ve tam tersine dönüştürmek için küresel coğrafi kodlama
  • Dünya çapında milyonlarca işletme, önemli nokta ve yer arasında ilgi noktası (POI) araması
  • Gerçek zamanlı trafik ile araba, yürüyüş ve bisiklet için çok modlu rota oluşturma
  • Erişilebilirliği analiz etmek ve lojistiği optimize etmek için seyahat süresi matrisleri
  • Birden fazla durak için en uygun ziyaret sırasını bulmak üzere rota optimizasyonu (gezgin satıcı problemi)
  • Temiz rota görselleştirmesi için GPS izlerini yol ağına oturtan harita eşleştirme
  • Belirli zaman veya mesafe kısıtlamaları dahilinde ulaşılabilir alanları görselleştirmek için izokron oluşturma
  • Konumların, rotaların ve coğrafi verilerin görsel temsillerini oluşturmak için statik harita görüntüleri
  • API çağrıları gerektirmeden mesafe, alan, kerteriz, tampon bölgeler ve mekansal analiz için çevrimdışı konumsal hesaplamalar

İster bir yapay zeka seyahat asistanı, lojistik optimize edici, konum tabanlı önerici veya "nerede"yi anlaması gereken herhangi bir uygulama geliştiriyor olun, Mapbox MCP Sunucusu bunu mümkün kılmak için mekansal zekayı sağlar. Ayrıca Claude Desktop ve VS Code gibi popüler istemcilerde de etkinleştirebilirsiniz. Ayrıntılar için aşağıya bakın

Mapbox MCP Server Demo

Kullanım

Bu MCP sunucusunu kullanmak için bir Mapbox erişim belirteci gereklidir.

Barındırılan MCP Uç Noktası

Hızlı erişim için barındırılan MCP uç noktamızı kullanabilirsiniz:

Uç Nokta: https://mcp.mapbox.com/mcp

Farklı istemciler için ayrıntılı kurulum talimatları ve API kullanımı için Barındırılan MCP Sunucu Kılavuzu sayfasına bakın.

Mapbox erişim belirteci almak için:

  1. mapbox.com/signup adresinden ücretsiz bir Mapbox hesabı oluşturun
  2. Hesap sayfanıza gidin
  3. Yeni bir belirteç oluşturun veya varsayılan genel belirteci kullanın

Mapbox erişim belirteçleri hakkında daha fazla bilgi için erişim belirteçleri hakkındaki Mapbox belgelerine bakın.

Entegrasyon Kılavuzları

Farklı entegrasyonlar için ayrıntılı kurulum talimatları için aşağıdaki kılavuzlara başvurun:

Örnek İstemler

Kurulumdan sonra Claude Desktop veya diğer MCP istemcileriyle bu istemleri deneyin:

Konum Keşfi

  • "Empire State Binası'na yürüme mesafesinde kahve dükkanları bul"
  • "Seattle'dan Portland'a gitmek istiyorum, yol üzerinde bir Starbucks var mı?"
  • "Boston'dan New York'a giden yol üzerindeki benzin istasyonlarını göster"
  • "Times Meydanı yakınında hangi restoranlar var?"

Navigasyon ve Seyahat

  • "LAX'ten Hollywood'a güncel trafikle araba yol tarifi al"
  • "Central Park'tan Times Meydanı'na yürümek ne kadar sürer?"
  • "Otelimden (Four Seasons) JFK Havalimanı'na yoğun saatte taksiyle seyahat süresini hesapla"

Görselleştirme ve Haritalar

  • "Golden Gate Köprüsü'nden Fisherman's Wharf'a giden rotayı her iki konumda işaretçilerle gösteren bir harita görüntüsü oluştur"
  • "Manhattan'ın önemli noktaların işaretlendiği bir uydu görüntüsünü göster"
  • "Seattle şehir merkezinin bir mil yakınındaki tüm Starbucks konumlarını vurgulayan bir harita oluştur"

Analiz ve Planlama

  • "Portland şehir merkezine arabayla 30 dakika içinde ulaşılabilir alanları göster"
  • "Denver'daki bu 3 otel konumu (Marriott, Sheraton ve Hilton) ile kongre merkezi arasında bir seyahat süresi matrisi hesapla"
  • "San Francisco'daki bu 3 turistik yeri (Golden Gate, Musical Stairs ve Fisherman's Wharf) ziyaret etmek için en uygun rotayı bul"
  • "Bu 8 adres için bir teslimat rotasını optimize et: [adres listesi]"

GPS ve Rota Eşleştirme

  • "Bu GPS izini temizle ve yollardaki gerçek rotayı göster: [zaman damgalı koordinat listesi]"
  • "Bu kaydedilmiş bisiklet sürüşünü bisiklet ağına oturt: [GPS koordinatları]"
  • "Bu araba rotasını yol ağına eşleştir ve trafik sıkışıklığı seviyelerini göster"

Çevrimdışı Konumsal Hesaplamalar

  • "Bu iki koordinat arasındaki mesafe mil cinsinden nedir?"
  • "Bu çokgenin alanını kilometrekare cinsinden hesapla"
  • "37.7749°K, 122.4194°B noktası bu hizmet alanı çokgeninin içinde mi?"
  • "San Francisco'dan New York'a kerteriz nedir?"
  • "Londra ve Paris arasındaki orta noktayı bul"
  • "Bu konumun etrafında 5 millik bir tampon bölge oluştur"
  • "Bu mahalle sınırının ağırlık merkezini hesapla"
  • "Bu rota koordinatları için sınırlayıcı kutu nedir?"
  • "Nokta sayısını azaltmak için bu karmaşık çokgeni basitleştir"

Daha İyi Sonuçlar İçin İpuçları

  • Konumlar hakkında belirli olun (tam adresler veya önemli nokta adları kullanın)
  • Tercih ettiğiniz seyahat yöntemini belirtin (araba, yürüyüş, bisiklet)
  • İlgili olduğunda zaman kısıtlamalarını dahil edin ("yoğun saatte", "saat 15:00'te")
  • Gerektiğinde belirli çıktı formatları isteyin ("harita görüntüsü olarak", "JSON formatında")

Ayrıntılı örnekler: Farklı kullanım durumları ve MCP Inspector test talimatlarıyla rota üzerinde arama isteminin kapsamlı örnekleri için examples/search-along-route.md sayfasına bakın.

Kaynaklar

MCP sunucusu, statik referans verilerini MCP kaynakları olarak sunar. Kaynaklar, istemcilerin araç çağrısı yapmadan doğrudan başvurabileceği verilere salt okunur erişim sağlar.

Mevcut Kaynaklar

Mapbox Kategoriler Kaynağı

URI Deseni: mapbox://categories veya mapbox://categories/{language}

Kategori arama aracıyla kullanılmak üzere mevcut kategori kimliklerinin tam listesine erişin. Kategoriler, arama sonuçlarını türe göre filtrelemek için kullanılabilir (örn., "restaurant", "hotel", "gas_station").

Örnekler:

  • mapbox://categories - Varsayılan (İngilizce) kategori listesi
  • mapbox://categories/ja - Japonca kategori adları
  • mapbox://categories/es - İspanyolca kategori adları

Kaynaklara Erişim:

  • Yerel MCP kaynak desteğine sahip istemciler: resources/read MCP protokol yöntemini kullanın
  • Kaynak desteği olmayan istemciler: Kaynak URI'si ile resource_reader_tool kullanın

Zengin Harita Önizlemeleri (MCP Uygulamaları)

static_map_image_tool, tüm istemcilerin aldığı base64 görüntüye ek olarak, uyumlu istemcilerde etkileşimli bir harita önizleme paneli sağlar.

Bu sunucu, sohbetin içinde doğrudan kendi kendine yeten bir HTML uygulama paneli oluşturan MCP Uygulamaları protokolünü (@modelcontextprotocol/ext-apps) uygular. Desteklenen istemciler, Tam Ekran geçiş düğmesine sahip etkileşimli bir harita gösterir:

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

Tüm istemciler, protokol desteğinden bağımsız olarak base64 kodlu harita görüntüsünü alır — etkileşimli önizlemeler, standart görüntü yanıtının üzerine aşamalı bir geliştirmedir.

Eski: MCP-UI

Bu sunucu ayrıca, gömülü iframe önizlemeleri için daha eski bir açık belirtim olan MCP-UI (@mcp-ui/server) desteğini de korur. MCP Uygulamaları önerilen protokoldür; MCP-UI desteği geriye dönük uyumluluk için tutulur.

MCP-UI varsayılan olarak etkindir. Devre dışı bırakmak için, bir komut satırı bayrağı olarak --disable-mcp-ui iletin veya ENABLE_MCP_UI=false ayarlayın. Ayrıntılar için MCP-UI belgelerine bakın.

CLIENT_NEEDS_RESOURCE_FALLBACK

Kaynak Yedek Araçları (Uyumsuz İstemciler için İsteğe Bağlı)

Kaynaklar, çoğu istemci tarafından desteklenen temel bir MCP özelliğidir (Claude Desktop, VS Code, MCP Inspector, vb.). Ancak, bazı istemciler (smolagents gibi) kaynakları hiç desteklemez. Bu istemciler için sunucu, kaynaklarla aynı içeriği ancak araç çağrıları yoluyla sunan "kaynak yedek araçları" sağlayabilir.

Yedek Araçlar:

  • resource_reader_tool - URI'ye göre herhangi bir kaynağı okumak için genel yedek
  • category_list_tool - Kategori listesine erişim sağlar (mapbox://categories)

Varsayılan olarak, bu araçlar DAHİL DEĞİLDİR (istemcinizin kaynakları desteklediğini varsayar). İstemciniz kaynakları desteklemiyorsa, yedek araçları etkinleştirin:

export CLIENT_NEEDS_RESOURCE_FALLBACK=true

Bunun ne zaman ayarlanacağı:

  • ✅ smolagents veya kaynak desteği olmayan diğer istemciler kullanılıyorsa true olarak ayarlayın
  • ❌ Claude Desktop, VS Code, MCP Inspector veya kaynak özellikli herhangi bir istemci kullanılıyorsa ayarlanmamış bırakın (varsayılan)
  • ❌ Emin değilseniz ayarlanmamış bırakın (çoğu istemci kaynakları destekler)

Araçlar

Yardımcı Araçlar

Kaynak Okuyucu Aracı

Yerel MCP kaynak API'sini desteklemeyen istemciler için MCP kaynaklarına erişim sağlar. Kategori listesi gibi kaynakları okumak için bu aracı kullanın.

Parametreler:

  • uri: Okunacak kaynak URI'si (örn., mapbox://categories, mapbox://categories/ja)

Örnek Kullanım:

  • Varsayılan kategorileri oku: {"uri": "mapbox://categories"}
  • Japonca kategorileri oku: {"uri": "mapbox://categories/ja"}

Not: MCP istemciniz yerel kaynakları destekliyorsa, daha iyi performans için doğrudan kaynak API'sini kullanmayı tercih edin.

Çevrimdışı Konumsal Araçlar

Bu araçlar, Mapbox API çağrıları gerektirmeden tamamen çevrimdışı olarak konumsal hesaplamalar yapar. Doğru coğrafi hesaplamalar için Turf.js kullanırlar ve internet bağlantısı olmadan bile her yerde çalışırlar.

Mesafe Aracı

Haversine formülünü kullanarak iki coğrafi koordinat arasındaki mesafeyi hesaplayın.

Özellikler:

  • Birden fazla birimi destekler: kilometre, mil, metre, fit, deniz mili
  • Doğru büyük daire mesafesi hesaplaması
  • API çağrısı gerekmez

Örnek Kullanım: "San Francisco (37.7749°K, 122.4194°B) ile New York (40.7128°K, 74.0060°B) arasındaki mesafe nedir?"

Çokgen İçinde Nokta Aracı

Bir noktanın bir çokgen veya çoklu çokgen içinde olup olmadığını test edin.

Özellikler:

  • Delikler dahil karmaşık çokgenlerle çalışır
  • Çoklu çokgenleri destekler
  • Coğrafi sınırlama ve hizmet alanı kontrolleri için kullanışlıdır

Örnek Kullanım: "Bu teslimat adresi hizmet alanımızın içinde mi?"

Kerteriz Aracı

Bir koordinattan diğerine pusula yönünü (kerteriz) hesaplayın.

Özellikler:

  • Kerterizi derece cinsinden döndürür (0-360°)
  • Ana yönü sağlar (K, KD, D, GD, G, GB, B, KB)
  • Navigasyon ve yön sorguları için kullanışlıdır

Örnek Kullanım: "Buradan havalimanına gitmek için hangi yöne gitmeliyim?"

Orta Nokta Aracı

Büyük daire yolu boyunca iki koordinat arasındaki coğrafi orta noktayı bulun.

Özellikler:

  • Dünya'nın kavisli yüzeyindeki gerçek orta noktayı hesaplar
  • Buluşma noktası önerileri için kullanışlıdır
  • Uzun mesafeli hesaplamaları doğru şekilde yapar

Örnek Kullanım: "San Francisco ile New York arasındaki orta nokta neresidir?"

Ağırlık Merkezi Aracı

Bir çokgenin veya çoklu çokgenin geometrik merkezini (ağırlık merkezi) hesaplayın.

Özellikler:

  • Karmaşık şekillerle çalışır
  • Tüm noktaların aritmetik ortalamasını döndürür
  • Etiket veya işaretçi yerleştirmek için kullanışlıdır

Örnek Kullanım: "Bu mahalle sınırı için işaretçiyi nereye yerleştirmeliyim?"

Alan Aracı

Bir çokgenin alanını hesaplayın.

Özellikler:

  • Birden fazla birimi destekler: metrekare, kilometrekare, dönüm, hektar, milkare, fitkare
  • Dünya yüzeyinde doğru alan hesaplaması
  • Her boyuttaki çokgenle çalışır

Örnek Kullanım: "Bu parkın alanı dönüm cinsinden nedir?"

Sınırlayıcı Kutu Aracı

Bir geometriyi içeren minimum sınırlayıcı kutuyu (bbox) hesaplayın.

Özellikler:

  • Noktalar, çizgiler, çokgenler ve çoklu çokgenlerle çalışır
  • [minBoylam, minEnlem, maxBoylam, maxEnlem] döndürür
  • Görünüm alanı hesaplamaları ve mekansal indeksleme için kullanışlıdır

Örnek Kullanım: "Bu rota için sınırlayıcı kutu nedir?"

Tampon Aracı

Bir nokta, çizgi veya poligon etrafında tampon bölge (poligon) oluşturur.

Özellikler:

  • Birden fazla mesafe birimini destekler
  • Noktalar etrafında dairesel tamponlar oluşturur
  • Yakınlık analizi ve etki alanları oluşturmak için kullanışlıdır

Örnek Kullanım: "Bu konumun etrafında 5 km'lik bir tampon bölge göster"

Basitleştirme Aracı

Douglas-Peucker algoritmasını kullanarak bir çizgi veya poligondaki köşe sayısını azaltır.

Özellikler:

  • Detay seviyesi için yapılandırılabilir tolerans
  • Karmaşıklığı azaltırken genel şekli korur
  • Dosya boyutlarını azaltmak ve işleme performansını artırmak için kullanışlıdır
  • Topolojiyi koruma seçeneği (kendi kendine kesişmeleri önler)

Örnek Kullanım: "Nokta sayısını azaltmak için bu karmaşık sınırı basitleştir"

Mapbox API Araçları

Kategori Listesi Aracı (Kullanımdan Kaldırıldı)

⚠️ Kullanımdan Kaldırıldı: Bunun yerine mapbox://categories URI'si ile resource_reader_tool kullanın veya istemciniz MCP kaynaklarını destekliyorsa doğrudan mapbox://categories kaynağına erişin.

Bu araç, MCP kaynaklarını veya resource_reader_tool'u desteklemeyen istemcilerle geriye dönük uyumluluk için korunmaktadır.

Matris Aracı

Mapbox Matrix API kullanarak birden fazla nokta arasındaki seyahat sürelerini ve mesafeleri hesaplar. Özellikler şunları içerir:

  • Verimli bire-çok, çoğa-bir veya çoğa-çok rota hesaplamaları
  • Farklı seyahat profilleri için destek (araba-trafik, araba, yürüme, bisiklet)
  • Trafik bilinçli hesaplamalar için kalkış zamanı belirtimi
  • Mesafe ve süre metrikleri ile rota özetleme
  • Yaklaşma kontrolü (kaldırım/sınırsız) ve izin verilen kalkış yönü aralığı

Statik görüntü aracı

Mapbox statik görüntü API kullanarak statik harita görüntüleri oluşturur. Özellikler şunları içerir:

  • Özel harita stilleri (sokaklar, açık hava, uydu, vb.)
  • Ayarlanabilir görüntü boyutları ve yakınlaştırma seviyeleri
  • Özel renkler ve etiketlerle birden fazla işaretçi desteği
  • Çoklu çizgiler ve poligonlar dahil kaplama seçenekleri
  • Belirtilen koordinatlara otomatik sığdırma

Kategori arama aracı

Mapbox Search Box kategori arama API kullanarak bir kategori araması gerçekleştirir. Özellikler şunları içerir:

  • Kategoriye göre ilgi çekici noktaları arama (restoranlar, oteller, benzin istasyonları, vb.)
  • Coğrafi yakınlığa göre filtreleme
  • Özelleştirilebilir sonuç limitleri
  • Her sonuç için zengin meta veriler
  • Birden fazla dil desteği

Ters coğrafi kodlama aracı

Mapbox geocoding V6 API kullanarak ters coğrafi kodlama gerçekleştirir. Özellikler şunları içerir:

  • Coğrafi koordinatları insan tarafından okunabilir adreslere dönüştürme
  • Özelleştirilebilir detay seviyeleri (sokak, mahalle, şehir, vb.)
  • Türe göre sonuç filtreleme (adres, ilgi çekici nokta, mahalle, vb.)
  • Birden fazla dil desteği
  • Zengin konum bağlam bilgisi

Yol Tarifi Aracı

Mapbox Directions API kullanarak rota tarifleri getirir. Özellikler şunları içerir:

  • Farklı rota profilleri için destek: araba (canlı trafik veya tipik), yürüme ve bisiklet
  • Birden fazla ara noktadan rota (2-25 koordinat çifti)
  • Alternatif rotalar seçeneği
  • Rota açıklamaları (mesafe, süre, hız, yoğunluk)
  • Zamanlama seçenekleri:
    • Araba ve araba-trafik profilleri için gelecekteki kalkış zamanı (depart_at)
    • Yalnızca araba profili için istenen varış zamanı (arrive_by)
  • Profile özel optimizasyonlar:
    • Araba: araç boyut kısıtlamaları (yükseklik, genişlik, ağırlık)
  • Rotalama için hariç tutma seçenekleri:
    • Yaygın hariç tutmalar: feribot rotaları, yalnızca nakit geçiş ücretleri
    • Arabaya özel hariç tutmalar: geçiş ücretleri, otoyollar, asfaltlanmamış yollar, tüneller, ülke sınırları, eyalet sınırları
    • Özel nokta hariç tutmaları (kaçınılacak 50'ye kadar coğrafi nokta)
  • GeoJSON geometri çıktı formatı

İzokron Aracı

Mapbox Isochrone API kullanarak bir konumdan belirli bir süre içinde ulaşılabilir alanları hesaplar. Özellikler şunları içerir:

  • Farklı seyahat profilleri için destek (araba, yürüme, bisiklet)
  • Özelleştirilebilir seyahat süreleri veya mesafeler
  • Birden fazla kontur oluşturma (ör. 15, 30, 45 dakika aralıkları)
  • İsteğe bağlı kalkış veya varış zamanı belirtimi
  • Görselleştirme için renk özelleştirme

Arama ve coğrafi kodlama aracı

Bu API tarafından desteklenen ilgi çekici noktaları, adresleri, yerleri ve diğer türleri aramak ve coğrafi kodlamak için Mapbox Search Box Text Search API uç noktasını kullanır. Bu araç, daha önce ForwardGeocodeTool ve PoiSearchTool (bu MCP sunucusunun önceki sürümlerinden) tarafından sağlanan işlevselliği tek bir araçta birleştirir.

Harita Eşleştirme Aracı

Mapbox Map Matching API kullanarak GPS izlerini yol ağına yaslar. Özellikler şunları içerir:

  • Gürültülü GPS izlerini yol ağındaki temiz rotalara dönüştürme
  • Farklı seyahat profilleri için destek (araba, araba-trafik, yürüme, bisiklet)
  • İstek başına 100'e kadar koordinat çifti işleme
  • Hıza dayalı gelişmiş doğruluk için isteğe bağlı zaman damgaları
  • Farklı GPS kalite seviyeleri için yapılandırılabilir yakalama yarıçapları
  • Rota açıklamaları (hız limitleri, mesafe, süre, trafik yoğunluğu)
  • Birden fazla geometri çıktı formatı (GeoJSON, çoklu çizgi)

Örnek Kullanım: "Bu GPS izini temizle ve yollara yasla: [zaman damgalı koordinatlar]"

Optimizasyon Aracı

Mapbox Optimization API kullanarak birden fazla konumdan geçen en uygun rotayı bulur. Özellikler şunları içerir:

  • 2-12 konum için gezgin satıcı problemini (TSP) çözme
  • Farklı seyahat profilleri için destek (araba, araba-trafik, yürüme, bisiklet)
  • Esnek başlangıç ve bitiş noktası yapılandırması
  • Gidiş-dönüş veya tek yönlü seyahat optimizasyonu
  • Adım adım navigasyon talimatları (isteğe bağlı)
  • Rota açıklamaları (mesafe, süre, hız)
  • Birden fazla geometri çıktı formatı (GeoJSON, çoklu çizgi)

Örnek Kullanım: "Bu 5 durağı ziyaret etmek için en uygun rotayı bul: [adres veya koordinat listesi]"

Not: Gelişmiş özelliklere (zaman pencereleri, kapasite kısıtlamaları, birden fazla araç) sahip bir V2 API mevcuttur ancak beta erişimi gerektirir. V2 uygulaması kod tabanında yer alır ancak varsayılan olarak kayıtlı değildir.

Geliştirme

Sunucuyu İnceleme

Node.js Kullanarak

# Run the built image
npm run inspect:build

Docker Kullanarak

# 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

Yeni Araç Oluşturma

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

Yeni Sürüm Yayınlama

# 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

Önemli: Yayıncı iş akışı, package.json ve server.json sürümlerinin yayın sürümüyle eşleştiğini doğrular. Sürüm artırımını veya manifest senkronizasyonunu atlamak yayın hatalarına neden olur.

OpenTelemetry İzleme

Bu MCP sunucusu, üretim gözlemlenebilirliği için kapsamlı OpenTelemetry izleme içerir:

Hızlı Demo

# 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

Not: Sunucu, başlangıçta .env dosyanızdan yapılandırmayı otomatik olarak yükler. .env.example dosyası, birden fazla gözlemlenebilirlik platformu için yapılandırma örnekleri içerir.

Desteklenen Gözlemlenebilirlik Platformları

.env.example içinde yer alan yapılandırma örnekleri:

Bulut Sağlayıcıları:

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

SaaS Platformları:

  • 📊 Datadog
  • 📊 New Relic
  • 📊 Honeycomb
  • 📊 Herhangi bir OTLP uyumlu arka uç

Üretim Yapılandırması

Aşağıdakileri içeren eksiksiz kurulum talimatları için docs/tracing.md belgesine bakın:

  • 🔧 Platforma özel yapılandırma kılavuzları
  • 📊 Kimlik doğrulama ve uç nokta kurulumu
  • 🎯 Özel iz öznitelikleri ve bağlam
  • 🚀 Performans optimizasyonu (minimum ek yük)
  • 🔍 Sorun giderme ve hata ayıklama

İzleme Özellikleri:

  • ✅ Yapılandırma yükleme izleme (.env dosya yükleme)
  • ✅ Otomatik araç yürütme izleme
  • ✅ CloudFront korelasyon kimlikleri ile HTTP istek enstrümantasyonu
  • ✅ Yapılandırılabilir dışa aktarıcılar (konsol, OTLP)
  • ✅ Güvenlik bilinçli (veri koruma, JWT doğrulama)
  • ✅ Üretime hazır (<%1 CPU ek yükü)

Katkıda Bulunma

Mapbox MCP Sunucusuna katkıları memnuniyetle karşılıyoruz! Bir pull request göndermeden önce lütfen CONTRIBUTING.md belgesini okuyun.

Tam standartlar ve yönergeler:

Katkıda Bulunanlar için Hızlı Başlangıç

  1. Depoyu çatallayın ve çatalınızı klonlayın
  2. Bağımlılıkları yükleyin: npm install
  3. Kodlama standartlarımıza uyarak değişikliklerinizi yapın
  4. Testleri ve linting'i çalıştırın: npm test && npm run lint
  5. Yeni işlevsellik için testler ekleyin
  6. Açık bir açıklama ile bir pull request gönderin

Tüm katkılar CI kontrollerimizden ve kod inceleme sürecimizden geçmelidir. Ayrıntılı gereksinimler için docs/engineering_standards.md belgesine bakın.

Veri Kullanımı ve Gizlilik

Mapbox API'lerine hangi veriler gönderilir

MCP sunucu araçlarını kullandığınızda, aşağıdaki veriler doğrudan ortamınızdan Mapbox API'lerine gönderilir:

  • Coğrafi kodlama araçları: Adres/konum metni, koordinatlar, ülke/bölge filtreleri
  • Arama araçları: Arama sorguları, yakınlık için konum koordinatları, kategori filtreleri
  • Yol tarifi aracı: Başlangıç/bitiş koordinatları, ara noktalar, rota tercihleri, araç kısıtlamaları
  • Matris aracı: Birden fazla koordinat çifti, seyahat profili, kalkış zamanları
  • Statik harita aracı: Koordinatlar, yakınlaştırma seviyesi, stil tercihleri, işaretçi bilgileri
  • İzokron aracı: Başlangıç koordinatları, zaman/mesafe parametreleri, seyahat profili

Gizliliğiniz

  • Yerel yürütme: Tüm API çağrıları doğrudan ortamınızdan Mapbox API'lerine yapılır
  • Token güvenliği: Mapbox API token'ınız yerel makinenizde kalır ve asla bu MCP sunucusuna iletilmez veya burada saklanmaz
  • Veri depolama yok: Bu MCP sunucusu, verilerinizi veya API isteklerinizi saklamaz, günlüğe kaydetmez veya toplamaz
  • Doğrudan iletişim: Siz ve Mapbox API'leri arasında aracı bir sunucu yoktur

Üçüncü taraf veri kullanımı

  • Mapbox'ın gizlilik politikası, API'lerine gönderilen verileri yönetir: https://www.mapbox.com/legal/privacy/
  • API kullanımı: Bu araçlar aracılığıyla yapılan tüm isteklere Standart Mapbox API koşulları uygulanır
  • Veri saklama: Veri saklama politikaları için Mapbox'ın belgelerine bakın

Destek ve İletişim

MCP Sunucu Sorunları İçin

Mapbox API Soruları İçin

Bakım Taahhüdü

Bu MCP sunucusu, Mapbox, Inc. tarafından resmi olarak sürdürülmektedir. Şunları sağlıyoruz:

  • Yeni Mapbox API özellikleri için düzenli güncellemeler
  • Hata düzeltmeleri ve güvenlik güncellemeleri
  • En son MCP protokol sürümleriyle uyumluluk
  • GitHub sorunları aracılığıyla topluluk desteği

MIT Lisansı