remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides navigation and geocoding capabilities through the Mapbox API, including routing between coordinates or place names, calculating travel time and distance matrices, and converting place names to coordinates.

Servidor MCP de Mapbox

Servidor MCP para la API de Mapbox.

Características

Herramientas de navegación

mapbox_directions
- Obtener 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_places
- Obtén direcciones entre lugares usando sus nombres
- Entradas:
  - places (string[]): Matriz de nombres de lugares
  - profile (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_matrix
- Calcular 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 fuente
  - destinations (opcional): Índices de coordenadas de destino
- Devuelve: Matriz de duraciones y/o distancias entre puntos
mapbox_matrix_by_places
- Calcular 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 letras
  - sources (opcional): Índices de lugares de origen
  - destinations (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_geocoding
- Busca 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 letras
  - fuzzyMatch (opcional): habilitar o deshabilitar la coincidencia difusa
- Devuelve: Información detallada de ubicación, incluidas coordenadas y propiedades.

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_here

Lí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 controladores
src/server/registry.ts : Registro para todos los controladores
src/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 classes

Diagrama 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.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools