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