Aidenyangx Mapbox MCP Server

🚀 Mapbox MCP Server

An MCP server serving the Mapbox API, providing navigation and search tools for location - related services.

✨ Features

Navigation Tools

1. mapbox_directions

   • Retrieve route information between coordinates.
   • Input:
     • coordinates ({latitude: number, longitude: number}[])
     • profile (optional): "driving - traffic", "driving", "walking", "cycling"
   • Return: Route details including steps, distance, and duration.

2. mapbox_directions_by_places

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

3. mapbox_matrix

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

4. mapbox_matrix_by_places

   • Calculate a matrix of travel times and distances using place names.
   • Input:
     • places (string array): 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): Index of source places.
     • destinations (optional): Index of destination places.
   • Return:
     • Geocoding results for each place.
     • A matrix of durations and/or distances.
     • Any errors that occur during processing.

Search Tools

1. mapbox_search
   • Search for place information based on query parameters.
   • Input:
     • query (string): Search keywords.
     • longitude (number): Longitude coordinate.
     • latitude (number): Latitude coordinate.
   • Return: A list containing matching places.

Class Diagram:

Flowchart:

🔧 Error Handling

All tools implement comprehensive error handling:

• Input validation errors
• API request failures
• Rate limit errors
• Specific service errors (e.g., route not found, invalid coordinates)

📄 License

This MCP server is licensed 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.