package
MCP App Server example with CesiumJS 3D globe and geocoding
npm install @modelcontextprotocol/server-mapGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.

Interactive 3D globe viewer using CesiumJS with OpenStreetMap tiles. Demonstrates geocoding integration and full MCP App capabilities.
Add to your MCP client configuration (stdio transport):
{
"mcpServers": {
"map": {
"command": "npx",
"args": [
"-y",
"--silent",
"--registry=https://registry.npmjs.org/",
"@modelcontextprotocol/server-map",
"--stdio"
]
}
}
}To test local modifications, use this configuration (replace ~/code/ext-apps with your clone path):
{
"mcpServers": {
"map": {
"command": "bash",
"args": [
"-c",
"cd ~/code/ext-apps/examples/map-server && npm run build >&2 && node dist/index.js --stdio"
]
}
}
}Install dependencies:
npm installBuild and start the server:
npm run start:http # for Streamable HTTP transport
# OR
npm run start:stdio # for stdio transportView using the basic-host example or another MCP Apps-compatible host.
geocodeSearch for places by name or address. Returns coordinates and bounding boxes.
{
"query": "Eiffel Tower"
}Returns up to 5 matches with lat/lon coordinates and bounding boxes.
show-mapDisplay the 3D globe zoomed to a bounding box.
{
"west": 2.29,
"south": 48.85,
"east": 2.3,
"north": 48.86,
"label": "Eiffel Tower"
}Defaults to London if no coordinates provided.
The map view registers tools on the view itself (via app.registerTool), for hosts that list and call view tools directly:
navigate-to — fly the globe to a bounding box, with an optional label.get-current-view — return the camera position and the visible bounding box (also as structuredContent).get-screenshot — capture the current globe view as a PNG image in the tool result (optional maxDimension, default 1024px), so the model can see exactly what the user sees.server.ts)Exposes two tools:
geocode - Queries OpenStreetMap Nominatim API with rate limitingshow-map - Renders the CesiumJS globe UI at a specified locationConfigures Content Security Policy to allow fetching tiles from OSM and Cesium CDN.
src/mcp-app.ts)Vanilla TypeScript app that:
server.ts - MCP server with geocode and show-map toolsmcp-app.html / src/mcp-app.ts - CesiumJS globe UImain.ts - HTTP and stdio server utilitiespcarleton
paul@modelcontextprotocol.io
Estimated unpacked size across 60 packages.
29.7 MB+
Includes dependencies.
^2.0.0
2.0.4