This guide explains how to configure Cursor IDE for use with the Mapbox MCP Server.
- Cursor installed
- Mapbox MCP Server built locally
# from repository root:
# using node
npm run build
# note your absolute path to node, you will need it for MCP config
# For Mac/Linux
which node
# For Windows
where node
# or alternatively, using docker
docker build -t mapbox-mcp-server .-
Go to Cursor Settings/ MCP Tools and click on "Add Custom MCP".
-
Add either of the following MCP config:
- NPM version
{ "mcpServers": { "MapboxServer": { "type": "stdio", "command": "<PATH_TO_YOUR_NPX>", "args": ["-y", "@mapbox/mcp-server"], "env": { "MAPBOX_ACCESS_TOKEN": "<YOUR_TOKEN>" } } } } - Docker version
{ "mcpServers": { "MapboxServer": { "type": "stdio", "command": "docker", "args": ["run", "-i", "--rm", "mapbox-mcp-server"], "env": { "MAPBOX_ACCESS_TOKEN": "<YOUR_TOKEN>" } } } } - Node version
{ "mcpServers": { "MapboxServer": { "type": "stdio", "command": "<PATH_TO_YOUR_NODE>", "args": ["/YOUR_PATH_TO_GIT_REPOSITORY/dist/index.js"], "env": { "MAPBOX_ACCESS_TOKEN": "<YOUR_TOKEN>" } } } }
- Click "Save" to apply the configuration.
- NPM version