Overview
Mapbox MCP Server is a server designed to interact with the Mapbox API, providing various navigation and geocoding tools.
To use the Mapbox MCP Server, set up the server by installing the required dependencies, configuring your Mapbox API key, and running the server with the appropriate commands.
- Navigation tools for getting directions and calculating travel times. - Geocoding capabilities to convert addresses into coordinates. - Comprehensive error handling for various API interactions.
- Finding directions between two geographical coordinates.
- Searching for places and converting them into coordinates.
- Calculating travel time and distance matrices for multiple locations.
Add to your AI client
Use these steps to connect Mapbox MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"aidenyangx-mapbox-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aidenyangx-mapbox-mcp-server-mcp-mirror"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"aidenyangx-mapbox-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aidenyangx-mapbox-mcp-server-mcp-mirror"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"aidenyangx-mapbox-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aidenyangx-mapbox-mcp-server-mcp-mirror"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"aidenyangx-mapbox-mcp-server-mcp-mirror": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aidenyangx-mapbox-mcp-server-mcp-mirror"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"aidenyangx-mapbox-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aidenyangx-mapbox-mcp-server-mcp-mirror"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"aidenyangx-mapbox-mcp-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aidenyangx-mapbox-mcp-server-mcp-mirror"
]
}
}
}FAQ
What are the prerequisites for using the server?
You need Node.js 16 or higher, TypeScript 4.5 or higher, and a valid Mapbox API key.
How do I get a Mapbox API key?
You can obtain a Mapbox API key by following the instructions on the Mapbox account access tokens page.
What are the rate limits for the APIs?
The Directions API allows 300 requests per minute, while the Geocoding API allows 600 requests per minute.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1219,"uuid":"12c81f9a-da6e-43d1-a003-ba86749b6316","name":"AidenYangX_mapbox-mcp-server","title":"Mapbox MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2025-01-28T02:38:28.224+00:00","updated_at":"2025-02-23T07:20:27.618+00:00","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"mapbox,mcp-server,navigation-tools","category":"location-services","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/AidenYangX_mapbox-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/MCP-Mirror/AidenYangX_mapbox-mcp-server/raw/main/assets/MapboxMCPServerClass.png","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]