Mapbox MCP Server

🚀 Mapbox MCP Server

An MCP server crafted for the Mapbox API, offering a suite of tools for navigation, input validation, and error handling.

✨ Features

Navigation Tools

1. mapbox_directions

   • Retrieve navigation routes based on coordinates.
   • Input Parameters:
     • coordinates ({latitude: number, longitude: number}[]): An array of coordinate objects.
     • profile (optional): "driving-traffic", "driving", "walking", "cycling".
   • Return Result: Route information including steps, distance, and duration.

2. mapbox_directions_by_places

   • Obtain navigation routes using place names.
   • Input Parameters:
     • places (string[]): An array of place names.
     • profile (optional): "driving-traffic", "driving", "walking", "cycling".
     • language (optional): Two-letter language code (e.g., "zh", "en").
   • Return Result:
     • Geocoding results for each place.
     • Detailed route information, including steps, distance, and duration.
     • Any errors that occur during processing.

3. mapbox_matrix

   • Calculate a matrix of travel times and distances between coordinate points.
   • Input Parameters:
     • coordinates ({latitude: number, longitude: number}[]): An array of coordinate objects.
     • profile (optional): "driving", "walking", "cycling".
     • annotations (optional): "duration", "distance", "duration,distance".
     • sources (optional): Indexes of source coordinate points.
     • destinations (optional): Indexes of destination coordinate points.
   • Return Result: A matrix of durations and/or distances.

4. mapbox_matrix_by_places

   • Compute a matrix of travel times and distances using place names.
   • Input Parameters:
     • places (string[]): An array of place names (2 - 25 places).
     • profile (optional): "driving", "walking", "cycling".
     • annotations (optional): "duration", "distance", "duration,distance".
     • language (optional): Two-letter language code.
     • sources (optional): Indexes of source places.
     • destinations (optional): Indexes of destination places.
   • Return Result:
     • Geocoding results for each place.
     • Distance matrix data.
     • Any errors that occur during processing.

Input Validation Tools

1. mapbox_input_validation
   • Validate the validity of input parameters.
   • Supported Validation Types: required, string, integer, number, boolean, array, object.
   • Return Result:
     • Valid input data.
     • Specific error information when validation fails.

Other Tools

1. mapbox_error_handling
   • Handle various exceptional situations.
   • Supported Error Types: input_error, api_request_failure, rate_limit_exceeded, service_specific_error.
   • Return Result:
     • Error code.
     • Error message.
     • Suggested solutions.

💻 Usage Examples

Basic Usage

{
  "name": "mapbox_mcp_server",
  "description": "Mapbox API's MCP server toolset",
  "version": "1.0.0",
  "parameters": {
    "api_key": {
      "type": "string",
      "required": true,
      "description": "Access key for the Mapbox API"
    },
    "tools": [
      "mapbox_directions",
      "mapbox_directions_by_places",
      "mapbox_matrix",
      "mapbox_matrix_by_places",
      "mapbox_input_validation",
      "mapbox_error_handling"
    ]
  }
}

📦 Installation

Environment Configuration

1. Install dependencies:

npm install mapbox-mcp-server express validator

2. Configure environment variables:

process.env.NODE_ENV = 'production';
process.env.MAPBOX_API_KEY = 'your_api_key_here';

📚 Documentation

Deployment Structure

Class Diagram:

Flowchart:

Error Handling

All tools implement a comprehensive error handling mechanism:

• Input validation failure
• API request failure
• Rate limit errors
• Service-specific errors (e.g., no available routes, invalid coordinates)

📄 License

This MCP server is distributed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.