mapbox-mcp-server

11
location_services

Mapbox MCP Server is a Model Context Protocol Server designed to interface with the Mapbox API, offering tools for navigation and search functionalities. It includes features for getting directions, calculating travel time matrices, and geocoding. The server supports comprehensive error handling and is structured for easy deployment.

Mapbox MCP Server

MCP Server for the Mapbox API.

Features

Navigation Tools

  • Provides tools to get directions and calculate travel matrices between coordinates or places.

Search Tools

  • Includes geocoding tools to search for places and convert addresses into coordinates.

Setup

Prerequisites

  • Node.js 16 or higher
  • TypeScript 4.5 or higher
  • A valid Mapbox API key

API Key

  • Get a Mapbox API key and set it as an environment variable.

Rate Limits

  • Directions API: 300 requests/min
  • Matrix API: 60 requests/min for driving/walking/cycling, 30 requests/min for driving-traffic
  • Geocoding API: 600 requests/min

Deployment

  • The server is structured with handlers and follows a specific code layout.

Error Handling

  • Comprehensive error handling is implemented for input validation, API request failures, rate limit errors, and service-specific errors.

License

  • Licensed under the MIT License.