Skip to main content
Glama

Servidor MCP de Mapbox

Servidor MCP para la API de Mapbox.

Características

Herramientas de navegación

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

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

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

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

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

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_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 clases del servidor mapbox-mcp


Diagrama de proceso : Diagrama de proceso del servidor mapbox-mcp

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 tools
mapbox_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

    B3.4/5.0

    Scored across 5 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers