mapbox-mcp-server
Servidor MCP de Mapbox
Servidor MCP para la API de Mapbox.
Características
Herramientas de navegación
mapbox_directionsObtener direcciones entre coordenadas
Entradas:
coordinates({latitud: número, longitud: número}[])profile(opcional): "tráfico de conducción", "conducción", "caminando", "ciclismo"
Devuelve: detalles de la ruta con pasos, distancia y duración.
mapbox_directions_by_placesObtén direcciones entre lugares usando sus nombres
Entradas:
places(string[]): Matriz de nombres de lugaresprofile(opcional): "tráfico de conducción", "conducción", "caminando", "ciclismo"language(opcional): código de idioma de dos letras (por ejemplo, "zh", "en")
Devoluciones:
Resultados de geocodificación para cada lugar
Detalles de la ruta con pasos, distancia y duración.
Cualquier error que haya ocurrido durante el procesamiento
mapbox_matrixCalcular matrices de tiempo de viaje y distancia entre coordenadas
Entradas:
coordinates({latitud: número, longitud: número}[])profile(opcional): "conduciendo", "caminando", "en bicicleta"annotations(opcionales): "duración", "distancia", "duración,distancia"sources(opcional): índices de coordenadas de la fuentedestinations(opcional): Índices de coordenadas de destino
Devuelve: Matriz de duraciones y/o distancias entre puntos
mapbox_matrix_by_placesCalcular matrices de tiempo y distancia de viaje entre lugares usando sus nombres
Entradas:
places(string[]): Matriz de nombres de lugares (2-25 lugares)profile(opcional): "conduciendo", "caminando", "en bicicleta"annotations(opcionales): "duración", "distancia", "duración,distancia"language(opcional): código de idioma de dos letrassources(opcional): Índices de lugares de origendestinations(opcional): Índices de lugares de destino
Devoluciones:
Resultados de geocodificación para cada lugar
Matriz de duraciones y/o distancias
Cualquier error que haya ocurrido durante el procesamiento
Herramientas de búsqueda
mapbox_geocodingBusca lugares y convierte direcciones en coordenadas
Entradas:
searchText(cadena): el lugar o la dirección que se buscarálimit(opcional): Número máximo de resultados (1-10)types(opcional): Filtrar por tipos de lugar (país, región, lugar, etc.)language(opcional): código de idioma de dos letrasfuzzyMatch(opcional): habilitar o deshabilitar la coincidencia difusa
Devuelve: Información detallada de ubicación, incluidas coordenadas y propiedades.
Related MCP server: Overture Maps MCP
Integración de escritorio de Claude
Agregue esta configuración a su archivo de configuración de Claude Desktop (normalmente ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json ):
{
"mcpServers": {
"mapbox-mcp-server": {
"command": "node",
"args": ["/absolute/path/to/mapbox-mcp-server/build/index.js"],
"env": {
"MAPBOX_ACCESS_TOKEN": "your-api-key"
}
}
}
}Configuración
Prerrequisitos
Node.js 16 o superior
TypeScript 4.5 o superior
Una clave API de Mapbox válida
Clave API
Obtenga una clave API de Mapbox siguiendo las instrucciones aquí .
Establezca su clave API como una variable de entorno:
export MAPBOX_ACCESS_TOKEN=your_api_key_hereLímites de velocidad
API de direcciones: 300 solicitudes por minuto
API de matriz:
60 solicitudes por minuto para conducir, caminar o andar en bicicleta
30 solicitudes por minuto para el tráfico de conducción
API de geocodificación: 600 solicitudes por minuto
Despliegue
Estructura
En mapbox-mcp-server, utilizamos la siguiente estructura para administrar los controladores del servidor:
src/server/handlers/base.ts: Clase base para todos los controladoressrc/server/registry.ts: Registro para todos los controladoressrc/server/main.ts: Punto de entrada principal para el servidor
Cada módulo de funciones sigue esta estructura:
src/
├── types/ # Type definitions
├── schemas/ # Zod schemas for validation
├── tools/
│ ├── definitions/ # Tool definitions
│ └── handlers/ # Tool implementations
└── server/
└── handlers/ # Handler classesDiagrama de clases : 
Diagrama de proceso : 
Manejo de errores
Todas las herramientas implementan un manejo integral de errores:
Errores de validación de entrada
Errores en las solicitudes de API
Errores de límite de velocidad
Errores específicos del servicio (por ejemplo, no se encontraron rutas, coordenadas no válidas)
Licencia
Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.
Available Tools
5 toolsmapbox_directionsC
Get navigation route between two points
Inputs: coordinates (required), profile.
mapbox_directions_by_placesC
Get navigation route between multiple places using their names
Inputs: places (required), profile, language.
mapbox_geocodingC
Search for places and convert addresses into coordinates
Inputs: searchText (required), limit, types, language, +1 more.
mapbox_matrixC
Calculate travel time and distance matrices between coordinates
Inputs: coordinates (required), profile, annotations, approaches, +5 more.
mapbox_matrix_by_placesC
Calculate travel time and distance matrices between places using their names
Inputs: places (required), profile, annotations, language, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
The tools are mostly distinct, with clear purposes like routing, geocoding, and matrix calculations. However, the two directions tools (mapbox_directions and mapbox_directions_by_places) and two matrix tools (mapbox_matrix and mapbox_matrix_by_places) could cause minor confusion as they overlap in functionality but differ in input types (coordinates vs. place names). Descriptions help clarify this distinction.
All tool names follow a consistent 'mapbox_' prefix with descriptive suffixes (e.g., directions, geocoding, matrix), using snake_case uniformly. The naming pattern is predictable and readable, making it easy for agents to understand the tool's purpose at a glance.
With 5 tools, the server is well-scoped for its mapping and navigation domain. Each tool serves a distinct function (e.g., routing, geocoding, matrix calculations), and the count is neither too sparse nor overwhelming, fitting typical use cases effectively.
The tool set covers core mapping operations like routing, geocoding, and travel time calculations, with good coverage for the domain. A minor gap might be the lack of tools for additional Mapbox services (e.g., static maps or spatial analysis), but the provided tools enable key workflows without significant dead ends.
Maintenance
Related MCP Connectors
The official MCP Server for the Mux API
MCP server for the Seline Analytics API
Related MCP Servers
- -licenseNot gradedqualityBmaintenanceMCP Server for the Google Maps API.11,868 npm92,139MIT
- FlicenseNot gradedqualityFmaintenancePython MCP server for querying Overture Maps building footprint data via address search, building lookups, and nearby building listings.-
- AlicenseBqualityDmaintenanceAn MCP server for forward geocoding via the Nominatim API (OpenStreetMap) with no API key required.17 npmMIT
- FlicenseNot gradedqualityBmaintenanceAn MCP server providing geocoding, routing, isochrones, and POI-by-proximity search through self-hosted OpenStreetMap backends.-