Map Canvas MCP

Un mapa interactivo integrado para hosts de MCP Apps como ChatGPT. El Worker devuelve los datos del mapa junto con un cargador de interfaz estable. Cada resultado de herramienta selecciona un paquete Leaflet con direccionamiento por contenido servido desde Cloudflare Static Assets, por lo que las actualizaciones de la interfaz no requieren actualizar los metadatos de herramienta que no han cambiado. El navegador del usuario obtiene las teselas de OpenStreetMap visibles directamente de los servidores de teselas estándar.

Endpoint de producción

https://map-canvas.android-mxdiego9.workers.dev/mcp

El endpoint es público y no requiere autenticación.

Related MCP server: Mapbox MCP Server

Desarrollo local

npm install
npm run check
npm run dev

npm run check comprueba los tipos del Worker y ejecuta pruebas de humo de MCP para la inicialización, el descubrimiento de herramientas, la ejecución de herramientas y la carga de recursos del widget.

El endpoint MCP local es http://localhost:8787/mcp. Pruébalo con el MCP Inspector:

npx @modelcontextprotocol/inspector@latest

Despliegue

Despliega desde una terminal:

npm run deploy

No se requiere ninguna clave de API. No añadas secretos al código fuente ni a wrangler.jsonc; usa los secretos de Cloudflare si se añade autenticación más adelante.

Despliegue con GitHub Actions

El flujo de trabajo incluido se despliega en cada push a main y luego ejecuta la prueba de humo MCP de producción contra el endpoint público. También puede ejecutarse manualmente desde la pestaña Actions. Añade primero estos secretos de Actions del repositorio:

• CLOUDFLARE_API_TOKEN: un token con permiso para editar Workers en la cuenta de destino

• CLOUDFLARE_ACCOUNT_ID: el ID de la cuenta de Cloudflare de destino

Los valores permanecen en los secretos de GitHub Actions y no deben confirmarse en el repositorio.

Herramienta

show_map acepta entre 1 y 50 lugares con coordenadas decimales de latitud/longitud. Los clientes simples pueden seguir usando connectPlaces; los itinerarios de viaje también pueden añadir:

• etiquetas de día/fecha y hora con filtrado por día

• categorías y estado confirmado/planificado/tentativo

• tramos de transporte para caminar, coche, taxi, autobús, tren, ferry y vuelos

• conexiones rectas esquemáticas o geometría de ruta real

• enlaces de lugar verificados, con un enlace de coordenadas de Google Maps como alternativa

El widget utiliza marcadores numerados de color por categoría, un panel de itinerario, una acción de restablecer la vista y presentación opcional a pantalla completa en ChatGPT. Los tramos esquemáticos son discontinuos y están etiquetados explícitamente para que no se confundan con navegación paso a paso.

Datos del mapa © colaboradores de OpenStreetMap.