Mapbox MCP Server

resmi

Buka kecerdasan geospasial melalui API Mapbox seperti geocoding, pencarian POI, petunjuk arah, isokron, dan lainnya.

GitHub
347

Dokumentasi

Server MCP Mapbox

npm version

Server Node.js yang mengimplementasikan Model Context Protocol (MCP) untuk API Mapbox.

Buka Kecerdasan Geospasial untuk Aplikasi AI Anda

Server MCP Mapbox mengubah agen atau aplikasi AI apa pun menjadi sistem yang sadar geospasial dengan menyediakan akses tanpa hambatan ke platform intelijen lokasi komprehensif Mapbox. Dengan server ini, AI Anda dapat memahami dan bernalar tentang tempat, menavigasi dunia fisik, dan mengakses data geospasial yang kaya termasuk:

  • Geocoding global untuk mengonversi alamat dan nama tempat menjadi koordinat dan sebaliknya
  • Pencarian titik minat (POI) di jutaan bisnis, landmark, dan tempat di seluruh dunia
  • Rute multi-moda untuk berkendara, berjalan kaki, dan bersepeda dengan lalu lintas waktu nyata
  • Matriks waktu tempuh untuk menganalisis aksesibilitas dan mengoptimalkan logistik
  • Optimasi rute untuk menemukan urutan kunjungan optimal untuk banyak pemberhentian (masalah pedagang keliling)
  • Pencocokan peta untuk menyesuaikan jejak GPS ke jaringan jalan untuk visualisasi rute yang bersih
  • Pembuatan isokron untuk memvisualisasikan area yang dapat dijangkau dalam batasan waktu atau jarak tertentu
  • Gambar peta statis untuk membuat representasi visual lokasi, rute, dan data geografis
  • Perhitungan geospasial offline untuk jarak, luas, arah, zona penyangga, dan analisis spasial tanpa memerlukan panggilan API

Baik Anda sedang membangun asisten perjalanan AI, pengoptimal logistik, pemberi rekomendasi berbasis lokasi, atau aplikasi apa pun yang perlu memahami "di mana", Server MCP Mapbox menyediakan kecerdasan spasial untuk mewujudkannya. Anda juga dapat mengaktifkannya di klien populer seperti Claude Desktop dan VS Code. Lihat di bawah untuk detailnya

Mapbox MCP Server Demo

Penggunaan

Token akses Mapbox diperlukan untuk menggunakan server MCP ini.

Endpoint MCP Hosted

Untuk akses cepat, Anda dapat menggunakan endpoint MCP hosted kami:

Endpoint: https://mcp.mapbox.com/mcp

Untuk petunjuk pengaturan terperinci untuk berbagai klien dan penggunaan API, lihat Panduan Server MCP Hosted.

Untuk mendapatkan token akses Mapbox:

  1. Daftar akun Mapbox gratis di mapbox.com/signup
  2. Buka halaman Akun Anda
  3. Buat token baru atau gunakan token publik default

Untuk informasi lebih lanjut tentang token akses Mapbox, lihat dokumentasi Mapbox tentang token akses.

Panduan Integrasi

Untuk petunjuk pengaturan terperinci untuk berbagai integrasi, lihat panduan berikut:

Contoh Prompt

Coba prompt ini dengan Claude Desktop atau klien MCP lainnya setelah pengaturan:

Penemuan Lokasi

  • "Temukan kedai kopi dalam jarak berjalan kaki dari Empire State Building"
  • "Saya ingin pergi dari Seattle ke Portland, apakah ada Starbucks di sepanjang jalan?"
  • "Tunjukkan pom bensin di sepanjang rute dari Boston ke New York"
  • "Restoran apa yang ada di dekat Times Square?"

Navigasi & Perjalanan

  • "Dapatkan arah berkendara dari LAX ke Hollywood dengan lalu lintas saat ini"
  • "Berapa lama waktu yang dibutuhkan untuk berjalan kaki dari Central Park ke Times Square?"
  • "Hitung waktu tempuh dari hotel saya (Four Seasons) ke Bandara JFK dengan taksi selama jam sibuk"

Visualisasi & Peta

  • "Buat gambar peta yang menunjukkan rute dari Golden Gate Bridge ke Fisherman's Wharf dengan penanda di kedua lokasi"
  • "Tunjukkan tampilan satelit Manhattan dengan landmark utama ditandai"
  • "Hasilkan peta yang menyoroti semua lokasi Starbucks dalam radius satu mil dari pusat kota Seattle"

Analisis & Perencanaan

  • "Tunjukkan area yang dapat dijangkau dalam 30 menit dari pusat kota Portland dengan mobil"
  • "Hitung matriks waktu tempuh antara 3 lokasi hotel ini (Marriott, Sheraton, dan Hilton) dan pusat konvensi di Denver"
  • "Temukan rute optimal mengunjungi 3 objek wisata ini (Golden Gate, Musical Stairs, dan Fisherman's Wharf) di San Francisco"
  • "Optimalkan rute pengiriman untuk 8 alamat ini: [daftar alamat]"

GPS & Pencocokan Rute

  • "Bersihkan jejak GPS ini dan tunjukkan rute sebenarnya di jalan: [daftar koordinat dengan stempel waktu]"
  • "Sesuaikan perjalanan sepeda yang direkam ini ke jaringan sepeda: [koordinat GPS]"
  • "Cocokkan rute berkendara ini ke jaringan jalan dan tunjukkan tingkat kemacetan lalu lintas"

Perhitungan Geospasial Offline

  • "Berapa jarak dalam mil antara dua koordinat ini?"
  • "Hitung luas poligon ini dalam kilometer persegi"
  • "Apakah titik pada 37.7749°LU, 122.4194°BB berada di dalam poligon area layanan ini?"
  • "Apa arah dari San Francisco ke New York?"
  • "Temukan titik tengah antara London dan Paris"
  • "Buat zona penyangga 5 mil di sekitar lokasi ini"
  • "Hitung pusat massa dari batas lingkungan ini"
  • "Apa kotak pembatas untuk koordinat rute ini?"
  • "Sederhanakan poligon kompleks ini untuk mengurangi jumlah titik"

Tips untuk Hasil yang Lebih Baik

  • Spesifik tentang lokasi (gunakan alamat lengkap atau nama landmark)
  • Tentukan metode perjalanan pilihan Anda (berkendara, berjalan kaki, bersepeda)
  • Sertakan batasan waktu jika relevan ("selama jam sibuk", "pada pukul 3 sore")
  • Minta format output tertentu saat diperlukan ("sebagai gambar peta", "dalam format JSON")

Contoh terperinci: Lihat examples/search-along-route.md untuk contoh komprehensif prompt pencarian-sepanjang-rute dengan berbagai kasus penggunaan dan petunjuk pengujian MCP Inspector.

Sumber Daya

Server MCP mengekspos data referensi statis sebagai sumber daya MCP. Sumber daya menyediakan akses hanya-baca ke data yang dapat dirujuk klien secara langsung tanpa melakukan panggilan alat.

Sumber Daya Tersedia

Sumber Daya Kategori Mapbox

Pola URI: mapbox://categories atau mapbox://categories/{language}

Akses daftar lengkap ID kategori yang tersedia untuk digunakan dengan alat pencarian kategori. Kategori dapat digunakan untuk memfilter hasil pencarian berdasarkan jenis (misalnya, "restaurant", "hotel", "gas_station").

Contoh:

  • mapbox://categories - Daftar kategori default (Bahasa Inggris)
  • mapbox://categories/ja - Nama kategori Bahasa Jepang
  • mapbox://categories/es - Nama kategori Bahasa Spanyol

Mengakses Sumber Daya:

  • Klien dengan dukungan sumber daya MCP native: Gunakan metode protokol MCP resources/read
  • Klien tanpa dukungan sumber daya: Gunakan resource_reader_tool dengan URI sumber daya

Pratinjau Peta Kaya (Aplikasi MCP)

static_map_image_tool menyediakan panel pratinjau peta interaktif di klien yang kompatibel, selain gambar base64 yang diterima semua klien.

Server ini mengimplementasikan protokol Aplikasi MCP (@modelcontextprotocol/ext-apps), yang merender panel aplikasi HTML mandiri langsung di dalam obrolan. Klien yang didukung menampilkan peta interaktif dengan tombol Layar Penuh:

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

Semua klien menerima gambar peta yang dienkode base64 terlepas dari dukungan protokol — pratinjau interaktif adalah peningkatan progresif di atas respons gambar standar.

Warisan: MCP-UI

Server ini juga mempertahankan dukungan untuk MCP-UI (@mcp-ui/server), spesifikasi terbuka sebelumnya untuk pratinjau iframe tertanam. Aplikasi MCP adalah protokol yang direkomendasikan; dukungan MCP-UI dipertahankan untuk kompatibilitas mundur.

MCP-UI diaktifkan secara default. Untuk menonaktifkannya, berikan --disable-mcp-ui sebagai flag baris perintah atau atur ENABLE_MCP_UI=false. Lihat dokumentasi MCP-UI untuk detailnya.

CLIENT_NEEDS_RESOURCE_FALLBACK

Alat Fallback Sumber Daya (Opt-In untuk Klien yang Tidak Patuh)

Sumber daya adalah fitur inti MCP yang didukung oleh sebagian besar klien (Claude Desktop, VS Code, MCP Inspector, dll.). Namun, beberapa klien (seperti smolagents) tidak mendukung sumber daya sama sekali. Untuk klien ini, server dapat menyediakan "alat fallback sumber daya" yang mengirimkan konten yang sama seperti sumber daya tetapi melalui panggilan alat.

Alat Fallback:

  • resource_reader_tool - Fallback umum untuk membaca sumber daya apa pun berdasarkan URI
  • category_list_tool - Menyediakan akses ke daftar kategori (mapbox://categories)

Secara default, alat ini TIDAK disertakan (mengasumsikan klien Anda mendukung sumber daya). Jika klien Anda tidak mendukung sumber daya, aktifkan alat fallback:

export CLIENT_NEEDS_RESOURCE_FALLBACK=true

Kapan harus mengatur ini:

  • ✅ Atur ke true jika menggunakan smolagents atau klien lain tanpa dukungan sumber daya
  • ❌ Biarkan tidak diatur (default) jika menggunakan Claude Desktop, VS Code, MCP Inspector, atau klien apa pun yang mampu sumber daya
  • ❌ Biarkan tidak diatur jika tidak yakin (sebagian besar klien mendukung sumber daya)

Alat

Alat Utilitas

Alat Pembaca Sumber Daya

Menyediakan akses ke sumber daya MCP untuk klien yang tidak mendukung API sumber daya MCP native. Gunakan alat ini untuk membaca sumber daya seperti daftar kategori.

Parameter:

  • uri: URI sumber daya yang akan dibaca (misalnya, mapbox://categories, mapbox://categories/ja)

Contoh Penggunaan:

  • Baca kategori default: {"uri": "mapbox://categories"}
  • Baca kategori Bahasa Jepang: {"uri": "mapbox://categories/ja"}

Catatan: Jika klien MCP Anda mendukung sumber daya native, lebih baik gunakan API sumber daya secara langsung untuk kinerja yang lebih baik.

Alat Geospasial Offline

Alat ini melakukan perhitungan geospasial sepenuhnya offline tanpa memerlukan panggilan API Mapbox. Mereka menggunakan Turf.js untuk komputasi geografis yang akurat dan bekerja di mana saja, bahkan tanpa konektivitas internet.

Alat Jarak

Hitung jarak antara dua koordinat geografis menggunakan rumus Haversine.

Fitur:

  • Mendukung berbagai unit: kilometer, mil, meter, kaki, mil laut
  • Perhitungan jarak lingkaran besar yang akurat
  • Tidak diperlukan panggilan API

Contoh Penggunaan: "Berapa jarak antara San Francisco (37.7749°LU, 122.4194°BB) dan New York (40.7128°LU, 74.0060°BB)?"

Alat Titik dalam Poligon

Uji apakah suatu titik berada di dalam poligon atau multipoligon.

Fitur:

  • Bekerja dengan poligon kompleks termasuk lubang
  • Mendukung multipoligon
  • Berguna untuk geofencing dan pemeriksaan area layanan

Contoh Penggunaan: "Apakah alamat pengiriman ini berada di dalam area layanan kami?"

Alat Arah

Hitung arah kompas (bearing) dari satu koordinat ke koordinat lainnya.

Fitur:

  • Mengembalikan arah dalam derajat (0-360°)
  • Menyediakan arah mata angin (U, TL, T, Tg, S, BD, B, BL)
  • Berguna untuk navigasi dan kueri arah

Contoh Penggunaan: "Ke arah mana saya harus pergi dari sini ke bandara?"

Alat Titik Tengah

Temukan titik tengah geografis antara dua koordinat di sepanjang jalur lingkaran besar.

Fitur:

  • Menghitung titik tengah sebenarnya di permukaan bumi yang melengkung
  • Berguna untuk saran titik pertemuan
  • Menangani perhitungan jarak jauh dengan benar

Contoh Penggunaan: "Apa titik tengah antara San Francisco dan New York?"

Alat Pusat Massa

Hitung pusat geometris (centroid) dari poligon atau multipoligon.

Fitur:

  • Bekerja dengan bentuk kompleks
  • Mengembalikan rata-rata aritmatika dari semua titik
  • Berguna untuk menempatkan label atau penanda

Contoh Penggunaan: "Di mana saya harus menempatkan penanda untuk batas lingkungan ini?"

Alat Luas

Hitung luas poligon.

Fitur:

  • Mendukung berbagai unit: meter persegi, kilometer persegi, acre, hektar, mil persegi, kaki persegi
  • Perhitungan luas yang akurat di permukaan bumi
  • Bekerja dengan poligon ukuran apa pun

Contoh Penggunaan: "Berapa luas taman ini dalam acre?"

Alat Kotak Pembatas

Hitung kotak pembatas minimum (bbox) yang berisi geometri.

Fitur:

  • Bekerja dengan titik, garis, poligon, dan multipoligon
  • Mengembalikan [minLongitude, minLatitude, maxLongitude, maxLatitude]
  • Berguna untuk perhitungan viewport dan pengindeksan spasial

Contoh Penggunaan: "Apa kotak pembatas untuk rute ini?"

Buffer Tool

Membuat zona buffer (poligon) di sekitar titik, garis, atau poligon.

Fitur:

  • Mendukung berbagai satuan jarak
  • Membuat buffer melingkar di sekitar titik
  • Berguna untuk analisis kedekatan dan pembuatan zona pengaruh

Contoh Penggunaan: "Tampilkan zona buffer 5km di sekitar lokasi ini"

Simplify Tool

Mengurangi jumlah verteks pada garis atau poligon menggunakan algoritma Douglas-Peucker.

Fitur:

  • Toleransi yang dapat dikonfigurasi untuk tingkat detail
  • Mempertahankan bentuk keseluruhan sambil mengurangi kompleksitas
  • Berguna untuk mengurangi ukuran file dan meningkatkan performa rendering
  • Opsi untuk mempertahankan topologi (mencegah self-intersection)

Contoh Penggunaan: "Sederhanakan batas kompleks ini untuk mengurangi jumlah titik"

Mapbox API Tools

Category List Tool (Usang)

⚠️ Usang: Gunakan resource_reader_tool dengan URI mapbox://categories sebagai gantinya, atau akses langsung resource mapbox://categories jika klien Anda mendukung resource MCP.

Tool ini dipertahankan untuk kompatibilitas mundur dengan klien yang tidak mendukung resource MCP atau resource_reader_tool.

Matrix Tool

Menghitung waktu tempuh dan jarak antara beberapa titik menggunakan Mapbox Matrix API. Fitur meliputi:

  • Perhitungan rute one-to-many, many-to-one, atau many-to-many yang efisien
  • Dukungan untuk berbagai profil perjalanan (driving-traffic, driving, walking, cycling)
  • Spesifikasi waktu keberangkatan untuk perhitungan yang sadar lalu lintas
  • Ringkasan rute dengan metrik jarak dan durasi
  • Kontrol pendekatan (curb/unrestricted) dan rentang bearing keberangkatan yang diizinkan

Static image tool

Menghasilkan gambar peta statis menggunakan Mapbox static image API. Fitur meliputi:

  • Gaya peta kustom (streets, outdoors, satellite, dll.)
  • Dimensi gambar dan level zoom yang dapat disesuaikan
  • Dukungan untuk beberapa penanda dengan warna dan label kustom
  • Opsi overlay termasuk polyline dan poligon
  • Penyesuaian otomatis ke koordinat yang ditentukan

Category search tool

Melakukan pencarian kategori menggunakan Mapbox Search Box category search API. Fitur meliputi:

  • Mencari tempat menarik berdasarkan kategori (restoran, hotel, SPBU, dll.)
  • Penyaringan berdasarkan kedekatan geografis
  • Batas hasil yang dapat disesuaikan
  • Metadata kaya untuk setiap hasil
  • Dukungan untuk berbagai bahasa

Reverse geocoding tool

Melakukan reverse geocoding menggunakan Mapbox geocoding V6 API. Fitur meliputi:

  • Mengonversi koordinat geografis menjadi alamat yang dapat dibaca manusia
  • Tingkat detail yang dapat disesuaikan (jalan, lingkungan, kota, dll.)
  • Penyaringan hasil berdasarkan tipe (alamat, poi, lingkungan, dll.)
  • Dukungan untuk berbagai bahasa
  • Informasi konteks lokasi yang kaya

Directions tool

Mengambil petunjuk arah rute menggunakan Mapbox Directions API. Fitur meliputi:

  • Dukungan untuk berbagai profil rute: driving (dengan lalu lintas langsung atau tipikal), walking, dan cycling
  • Rute dari beberapa titik jalan (2-25 pasangan koordinat)
  • Opsi rute alternatif
  • Anotasi rute (jarak, durasi, kecepatan, kemacetan)
  • Opsi penjadwalan:
    • Waktu keberangkatan di masa depan (depart_at) untuk profil driving dan driving-traffic
    • Waktu kedatangan yang diinginkan (arrive_by) hanya untuk profil driving
  • Optimasi spesifik profil:
    • Driving: batasan dimensi kendaraan (tinggi, lebar, berat)
  • Opsi pengecualian untuk rute:
    • Pengecualian umum: rute feri, tol khusus tunai
    • Pengecualian khusus driving: tol, jalan motor, jalan tidak beraspal, terowongan, perbatasan negara, perbatasan negara bagian
    • Pengecualian titik kustom (hingga 50 titik geografis untuk dihindari)
  • Format output geometri GeoJSON

Isochrone tool

Menghitung area yang dapat dijangkau dalam jumlah waktu tertentu dari suatu lokasi menggunakan Mapbox Isochrone API. Fitur meliputi:

  • Dukungan untuk berbagai profil perjalanan (driving, walking, cycling)
  • Waktu atau jarak tempuh yang dapat disesuaikan
  • Pembuatan beberapa kontur (misalnya, rentang 15, 30, 45 menit)
  • Spesifikasi waktu keberangkatan atau kedatangan opsional
  • Kustomisasi warna untuk visualisasi

Search and geocode tool

Menggunakan endpoint Mapbox Search Box Text Search API untuk mendukung pencarian dan geocoding POI, alamat, tempat, dan tipe lain yang didukung oleh API tersebut. Tool ini menggabungkan fungsionalitas yang sebelumnya disediakan oleh ForwardGeocodeTool dan PoiSearchTool (dari versi sebelumnya server MCP ini) menjadi satu tool.

Map matching tool

Menyesuaikan jejak GPS ke jaringan jalan menggunakan Mapbox Map Matching API. Fitur meliputi:

  • Mengonversi jejak GPS yang berisik menjadi rute bersih di jaringan jalan
  • Dukungan untuk berbagai profil perjalanan (driving, driving-traffic, walking, cycling)
  • Menangani hingga 100 pasangan koordinat per permintaan
  • Stempel waktu opsional untuk akurasi yang lebih baik berdasarkan kecepatan
  • Radius snap yang dapat dikonfigurasi untuk tingkat kualitas GPS yang berbeda
  • Anotasi rute (batas kecepatan, jarak, durasi, kemacetan lalu lintas)
  • Berbagai format output geometri (GeoJSON, polyline)

Contoh Penggunaan: "Bersihkan jejak GPS ini dan sesuaikan ke jalan: [koordinat dengan stempel waktu]"

Optimization tool

Menemukan rute optimal melalui beberapa lokasi menggunakan Mapbox Optimization API. Fitur meliputi:

  • Menyelesaikan masalah traveling salesman (TSP) untuk 2-12 lokasi
  • Dukungan untuk berbagai profil perjalanan (driving, driving-traffic, walking, cycling)
  • Konfigurasi titik awal dan akhir yang fleksibel
  • Optimasi perjalanan pulang-pergi atau satu arah
  • Petunjuk navigasi belokan demi belokan (opsional)
  • Anotasi rute (jarak, durasi, kecepatan)
  • Berbagai format output geometri (GeoJSON, polyline)

Contoh Penggunaan: "Temukan rute optimal untuk mengunjungi 5 pemberhentian ini: [daftar alamat atau koordinat]"

Catatan: API V2 dengan fitur lanjutan (jendela waktu, batasan kapasitas, beberapa kendaraan) tersedia tetapi memerlukan akses beta. Implementasi V2 disertakan dalam basis kode tetapi tidak terdaftar secara default.

Pengembangan

Memeriksa server

Menggunakan Node.js

# Run the built image
npm run inspect:build

Menggunakan 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

Membuat tool baru

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

Merilis Versi Baru

# 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

Penting: Alur kerja penerbit memvalidasi bahwa versi package.json dan server.json cocok dengan versi rilis. Melewatkan peningkatan versi atau sinkronisasi manifes akan menyebabkan kegagalan penerbitan.

OpenTelemetry Tracing

Server MCP ini menyertakan OpenTelemetry tracing yang komprehensif untuk observabilitas produksi:

Demo Cepat

# 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

Catatan: Server secara otomatis memuat konfigurasi dari file .env Anda saat startup. File .env.example menyertakan contoh konfigurasi untuk berbagai platform observabilitas.

Platform Observabilitas yang Didukung

Contoh konfigurasi disertakan dalam .env.example untuk:

Penyedia Cloud:

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

Platform SaaS:

  • 📊 Datadog
  • 📊 New Relic
  • 📊 Honeycomb
  • 📊 Backend apa pun yang kompatibel dengan OTLP

Konfigurasi Produksi

Lihat docs/tracing.md untuk petunjuk pengaturan lengkap termasuk:

  • 🔧 Panduan konfigurasi spesifik platform
  • 📊 Pengaturan autentikasi dan endpoint
  • 🎯 Atribut dan konteks trace kustom
  • 🚀 Optimasi performa (overhead minimal)
  • 🔍 Pemecahan masalah dan debugging

Fitur Tracing:

  • ✅ Tracing pemuatan konfigurasi (pemuatan file .env)
  • ✅ Tracing eksekusi tool otomatis
  • ✅ Instrumentasi permintaan HTTP dengan ID korelasi CloudFront
  • ✅ Eksportir yang dapat dikonfigurasi (console, OTLP)
  • ✅ Sadar keamanan (perlindungan data, validasi JWT)
  • ✅ Siap produksi (<1% overhead CPU)

Berkontribusi

Kami menyambut kontribusi untuk Mapbox MCP Server! Silakan baca CONTRIBUTING.md sebelum mengirimkan pull request.

Standar dan pedoman lengkap:

Mulai Cepat untuk Kontributor

  1. Fork repositori dan clone fork Anda
  2. Instal dependensi: npm install
  3. Buat perubahan Anda mengikuti standar pengkodean kami
  4. Jalankan pengujian dan linting: npm test && npm run lint
  5. Tambahkan pengujian untuk fungsionalitas baru apa pun
  6. Kirimkan pull request dengan deskripsi yang jelas

Semua kontribusi harus lulus pemeriksaan CI dan proses tinjauan kode kami. Lihat docs/engineering_standards.md untuk persyaratan terperinci.

Penggunaan Data & Privasi

Data apa yang dikirim ke API Mapbox

Saat Anda menggunakan tool server MCP, data berikut dikirim langsung dari lingkungan Anda ke API Mapbox:

  • Tool Geocoding: Teks alamat/lokasi, koordinat, filter negara/wilayah
  • Tool Pencarian: Kueri pencarian, koordinat lokasi untuk kedekatan, filter kategori
  • Tool Directions: Koordinat awal/akhir, titik jalan, preferensi rute, batasan kendaraan
  • Tool Matrix: Beberapa pasangan koordinat, profil perjalanan, waktu keberangkatan
  • Tool Peta Statis: Koordinat, level zoom, preferensi gaya, informasi penanda
  • Tool Isochrone: Koordinat asal, parameter waktu/jarak, profil perjalanan

Privasi Anda

  • Eksekusi lokal: Semua panggilan API dilakukan langsung dari lingkungan Anda ke API Mapbox
  • Keamanan token: Token API Mapbox Anda tetap berada di mesin lokal Anda dan tidak pernah dikirimkan ke atau disimpan oleh server MCP ini
  • Tidak ada penyimpanan data: Server MCP ini tidak menyimpan, mencatat, atau mengumpulkan data atau permintaan API Anda
  • Komunikasi langsung: Tidak ada server perantara antara Anda dan API Mapbox

Penggunaan data pihak ketiga

  • Kebijakan privasi Mapbox mengatur data yang dikirim ke API mereka: https://www.mapbox.com/legal/privacy/
  • Penggunaan API: Ketentuan API Mapbox standar berlaku untuk semua permintaan yang dibuat melalui tool ini
  • Penyimpanan data: Lihat dokumentasi Mapbox untuk kebijakan penyimpanan data mereka

Dukungan & Kontak

Untuk Masalah Server MCP

Untuk Pertanyaan API Mapbox

Komitmen Pemeliharaan

Server MCP ini secara resmi dikelola oleh Mapbox, Inc. Kami menyediakan:

  • Pembaruan rutin untuk fitur API Mapbox baru
  • Perbaikan bug dan pembaruan keamanan
  • Kompatibilitas dengan versi protokol MCP terbaru
  • Dukungan komunitas melalui GitHub issues

Lisensi MIT