GPT Maps
Renders interactive maps using MapLibre GL, displaying markers, paths, and polygons.
Uses OpenStreetMap's Nominatim API to resolve geographic boundaries for countries and regions.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
GPT Maps
Turn map questions into live graphics. You chat in plain language; a Groq-powered agent calls MCP tools to build a geographic scene; MapLibre draws markers, driving routes, and region outlines on an interactive map.
Demo: gpt-maps.onrender.com · Upstream: SiddharthGoel-07/GPT-MAPS
Highlights
Mode | What you get |
Map queries | “Show Delhi and Mumbai and connect them” → geocoded pins, OSRM paths, optional region polygons |
Trip planner | Multi-day itineraries, per-day maps, budget view, section follow-up chat |
MCP server | Same drawing logic for browser or Claude Desktop–style MCP hosts (one scene per session) |
Map objects: markers, labels, paths (road or straight-line fallback), polygons (Nominatim boundaries, simplified for large areas).
MCP tools: createMarker · createLabel · createPath · createPolygon · removeObject · clearScene · renderScene
Related MCP server: geo-mcp
Architecture
flowchart TB
subgraph client["Browser :5173"]
UI["React UI<br/>Map queries · Trip planner"]
MR["MapRenderer<br/>MapLibre GL"]
UI --> MR
end
subgraph ai["ai-server :3002"]
API["/api/chat · /api/trip"]
Loop["Groq LLM + tool loop"]
API --> Loop
end
subgraph mcp["server :3001"]
MCP["MCP HTTP /mcp"]
Tools["createMarker · createPath · … · renderScene"]
Scene[("Scene per session")]
MCP --> Tools --> Scene
end
subgraph shared["@map-renderer/shared"]
Schema["Scene schema · trip models"]
end
subgraph external["External APIs"]
NOM["Nominatim"]
OSRM["OSRM"]
GROQ["Groq API"]
end
UI -->|"POST /api/*"| API
Loop --> GROQ
Loop -->|"MCP tool calls"| MCP
Tools --> NOM
Tools --> OSRM
Scene -->|"scene JSON"| Loop
Loop -->|"scene JSON"| API
API -->|"scene JSON"| MR
Schema -.-> Scene
Schema -.-> MR
Schema -.-> APIPackage | Responsibility |
| Zod scene schema, types, trip JSON models |
| MCP HTTP, geocoding, routing, boundaries |
|
|
| UI, map rendering, Vite proxy |
Quick start
Needs: Node 20+, npm, at least one Groq API key.
git clone https://github.com/SiddharthGoel-07/GPT-MAPS.git
cd GPT-MAPS
npm install
npm run build -w @map-renderer/sharedCreate packages/ai-server/.env from .env.example:
GROQ_API_KEY_1=gsk_...
MCP_SERVER_URL=http://127.0.0.1:3001/mcp
PORT=3002
GROQ_MODEL=openai/gpt-oss-20bRun everything from the repo root:
npm run devOpen http://localhost:5173 — Map queries or Trip planner in the header.
Tip: Other packages import
@map-renderer/sharedfromdist/. If you see “does not provide an export named …”, runnpm run build -w @map-renderer/shared(or use rootnpm run dev, which builds shared first).
Optional packages/server/.env: MCP_AUTH_TOKEN, body-size limits, Nominatim pacing — see httpGuard / server config in code.
Commands
Script | Use |
| Shared watch + server + ai-server + web |
| One service only |
| Production build all workspaces |
| Unit + integration harnesses |
| build + test + lint |
Stack
TypeScript · Model Context Protocol · MapLibre GL · React · Vite · OpenStreetMap / Nominatim · public OSRM routing
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server giving Claude AI access to 22+ NYC public-record databases for real estate due diligence
MCP server for AI dialogue using various LLM models via AceDataCloud
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that gives LLMs access to geographic data conversion tools, enabling transformations between different formats like WKT, GeoJSON, CSV, TopoJSON, and KML, as well as performing reverse geocoding.912 npm18MIT
- FlicenseAqualityDmaintenanceOSM-backed multimodal navigation MCP server enabling geocoding, route planning, POI discovery, and urban layout analysis. It provides a structured city graph to LLM apps without proprietary map APIs.8-
- AlicenseAqualityDmaintenanceAn MCP server that provides live geospatial data such as geocoding, POI search, isochrones, and area density from open data sources to LLM clients like Claude, Cursor, or Claude Code.6MIT
- AlicenseAqualityDmaintenanceAn OpenStreetMap MCP server that provides location-based services including geocoding, route directions, points of interest search, and neighborhood analysis to enhance LLMs with geospatial capabilities.121MIT